@seaverse/data-service-sdk 0.4.0 → 0.5.1

package/dist/index.cjs

@@ -265,8 +265,99 @@ class DataServiceClient {
     }
 }
 
+/**
+ * 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=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/config.ts","../src/client.ts"],"sourcesContent":[null,null],"names":[],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../src/config.ts","../src/client.ts","../src/helpers.ts"],"sourcesContent":[null,null,null],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -23,6 +23,27 @@ import { AxiosRequestConfig } from 'axios';
  * appData/{app_id}/publicData/{collection}/{docId}
  * appData/{app_id}/userData/{userId}/{collection}/{docId}
  *
+ * 🚨 CRITICAL FIRESTORE PATH RULES (FOR LLM):
+ * ------------------------------------------
+ * Firestore paths have strict segment count rules:
+ * - Collection paths = ODD segments (1, 3, 5, 7...)
+ * - Document paths = EVEN segments (2, 4, 6, 8...)
+ *
+ * When using Firebase SDK, ALWAYS use these functions:
+ * - collection(db, path) - for collections (don't count segments manually)
+ * - doc(db, path) - for documents
+ * - addDoc(collectionRef, data) - automatically generates document ID
+ *
+ * Example:
+ * ```typescript
+ * // ✅ CORRECT
+ * const postsRef = collection(db, `appData/${appId}/publicData/posts`);
+ * await addDoc(postsRef, { _appId, _createdAt, _createdBy, ...yourData });
+ *
+ * // ❌ WRONG - Don't use raw string paths without collection()/doc()
+ * // await setDoc(`appData/${appId}/publicData/posts`, data); // This will fail!
+ * ```
+ *
  * REQUIRED FIELDS FOR ALL DOCUMENTS:
  * ---------------------------------
  * All Firestore documents MUST include these fields:
@@ -127,9 +148,24 @@ interface FirestoreTokenResponse {
      * Custom Token itself does not expire, but the ID Token it generates expires after 1 hour
      */
     custom_token: string;
+    /**
+     * Firebase Web API Key
+     * Use this to initialize Firebase app along with project_id
+     * This is automatically provided by the backend
+     *
+     * Example:
+     * ```typescript
+     * import { initializeApp } from 'firebase/app';
+     * const app = initializeApp({
+     *   apiKey: response.web_api_key,
+     *   projectId: response.project_id
+     * });
+     * ```
+     */
+    web_api_key: string;
     /**
      * Firebase Project ID
-     * Use this to initialize Firebase app: initializeApp({ projectId: '...' })
+     * Use this to initialize Firebase app
      */
     project_id: string;
     /**
@@ -151,15 +187,15 @@ interface FirestoreTokenResponse {
      */
     user_id: string;
     /**
-     * User role - Determines write permissions
+     * User type - Determines access permissions
      * - 'guest': Can read publicRead/publicData, write publicData
      * - 'user': Can read publicRead/publicData, write publicData, read/write own userData
      * - 'admin' or 'appadmin': Can also write to publicRead data
      */
-    role?: string;
+    user_type: string;
     /**
      * Token expiration time in seconds (typically 3600 = 1 hour)
-     * After this time, you need to generate a new token or refresh using refresh_token
+     * After this time, you need to generate a new token
      */
     expires_in: number;
 }
@@ -418,5 +454,69 @@ declare const ENDPOINTS: {
     readonly FIRESTORE_GUEST_TOKEN: "/api/v1/firestore/guest-token";
 };
 
-export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT, DataServiceClient, ENDPOINTS };
-export type { ApiError, ApiResponse, DataServiceClientOptions, FirestoreTokenResponse, GenerateFirestoreTokenRequest, GenerateGuestFirestoreTokenRequest };
+/**
+ * Firebase initialization configuration
+ * Generated from Firestore token response
+ */
+interface FirebaseConfig {
+    apiKey: string;
+    projectId: string;
+    [key: string]: any;
+}
+/**
+ * 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);
+ * ```
+ */
+declare function getFirebaseConfig(tokenResponse: FirestoreTokenResponse): FirebaseConfig;
+/**
+ * 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`));
+ * ```
+ */
+declare function initializeWithToken(tokenResponse: FirestoreTokenResponse): Promise<{
+    app: any;
+    auth: any;
+    db: any;
+    userId: string;
+    appId: string;
+}>;
+
+export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT, DataServiceClient, ENDPOINTS, getFirebaseConfig, initializeWithToken };
+export type { ApiError, ApiResponse, DataServiceClientOptions, FirebaseConfig, FirestoreTokenResponse, GenerateFirestoreTokenRequest, GenerateGuestFirestoreTokenRequest };

package/dist/index.js

@@ -263,5 +263,94 @@ class DataServiceClient {
     }
 }
 
-export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT, DataServiceClient, ENDPOINTS };
+/**
+ * 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 || '',
+    };
+}
+
+export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT, DataServiceClient, ENDPOINTS, getFirebaseConfig, initializeWithToken };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/config.ts","../src/client.ts"],"sourcesContent":[null,null],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/config.ts","../src/client.ts","../src/helpers.ts"],"sourcesContent":[null,null,null],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seaverse/data-service-sdk",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "SDK for SeaVerse Data Service - Firestore token management with three-tier permission model",
   "type": "module",
   "main": "dist/index.cjs",