feat: add named Firestore database support and migrate CI to pnpm

- Add optional Database ID field in the Service Account connection dialog,
  enabling connections to named Firestore databases instead of only (default)
- Propagate databaseId through the full chain: UI → Redux → preload → backend
- Persist databaseId in localStorage for automatic reconnection
- Expose FieldValue, Filter, Timestamp, and GeoPoint in JS Query sandbox
- Migrate GitHub Actions workflows (CI + Build & Release) from npm to pnpm
- Update README, SECURITY.md, husky hooks, and error messages for pnpm
- Add unit tests for controllers and Redux slices with vitest
- Add test step to CI workflow

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: Juan Pablo Díaz S.

.github/workflows/build.yml

@@ -13,14 +13,17 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '22'
-          cache: 'npm'
+          cache: 'pnpm'
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Create .env file
         run: |
@@ -29,11 +32,11 @@ jobs:
 
       - name: Build Windows (unsigned)
         if: vars.ENABLE_CODE_SIGNING != 'true'
-        run: npm run build:win
+        run: pnpm run build:win
 
       - name: Build Windows (signed)
         if: vars.ENABLE_CODE_SIGNING == 'true'
-        run: npm run build:win
+        run: pnpm run build:win
         env:
           CSC_LINK: ${{ secrets.WINDOWS_CERTIFICATE }}
           CSC_KEY_PASSWORD: ${{ secrets.WINDOWS_CERTIFICATE_PASSWORD }}
@@ -53,14 +56,17 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '22'
-          cache: 'npm'
+          cache: 'pnpm'
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Create .env file
         run: |
@@ -69,11 +75,11 @@ jobs:
 
       - name: Build macOS (unsigned)
         if: vars.ENABLE_CODE_SIGNING != 'true'
-        run: npm run build:mac
+        run: pnpm run build:mac
 
       - name: Build macOS (signed)
         if: vars.ENABLE_CODE_SIGNING == 'true'
-        run: npm run build:mac
+        run: pnpm run build:mac
         env:
           CSC_LINK: ${{ secrets.APPLE_CERTIFICATE }}
           CSC_KEY_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
@@ -96,22 +102,25 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '22'
-          cache: 'npm'
+          cache: 'pnpm'
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Create .env file
         run: |
           echo "GOOGLE_CLIENT_ID=${{ secrets.GOOGLE_CLIENT_ID }}" > .env
           echo "GOOGLE_CLIENT_SECRET=${{ secrets.GOOGLE_CLIENT_SECRET }}" >> .env
 
       - name: Build Linux
-        run: npm run build:linux
+        run: pnpm run build:linux
 
       - name: Upload Linux artifacts
         uses: actions/upload-artifact@v4

.github/workflows/ci.yml

@@ -12,20 +12,26 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '22'
-          cache: 'npm'
+          cache: 'pnpm'
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Lint
-        run: npm run lint
+        run: pnpm run lint
 
       - name: Format check
-        run: npm run format:check
+        run: pnpm run format:check
 
       - name: Typecheck
-        run: npm run typecheck
+        run: pnpm run typecheck
+
+      - name: Tests
+        run: pnpm run test

.gitignore

@@ -1,5 +1,6 @@
 # Dependencies
 node_modules/
+package-lock.json
 
 # Build outputs
 dist/

.husky/pre-commit

@@ -1,2 +1,2 @@
-npx lint-staged
-npm run typecheck
+pnpm exec lint-staged
+pnpm run typecheck

.npmrc

@@ -0,0 +1 @@
+node-linker=hoisted

README.md

@@ -117,7 +117,7 @@ async function run() {
 ### Prerequisites
 
 - **Node.js** 18 or higher
-- **npm** or **yarn**
+- **pnpm** (`npm install -g pnpm`)
 - A **Firebase project**
 
 ### Installation
@@ -157,10 +157,10 @@ git clone https://github.com/Flowdesktech/firestudio.git
 cd firestudio
 
 # Install dependencies
-npm install
+pnpm install
 
 # Start the application
-npm run dev
+pnpm run dev
 ```
 
 ### Connecting to Your Firebase Project
@@ -196,26 +196,26 @@ See detailed OAuth setup guide in the [Google Sign-In Setup](#google-sign-in-set
 
 ### Development
 
-| Command            | Description                                 |
-| ------------------ | ------------------------------------------- |
-| `npm run dev`      | Start the full Electron app with hot reload |
-| `npm run dev:vite` | Start browser-only mode (limited features)  |
-| `npm run build`    | Build the React app for production          |
+| Command             | Description                                 |
+| ------------------- | ------------------------------------------- |
+| `pnpm run dev`      | Start the full Electron app with hot reload |
+| `pnpm run dev:vite` | Start browser-only mode (limited features)  |
+| `pnpm run build`    | Build the React app for production          |
 
 ### Building Releases
 
-| Command               | Description                                        |
-| --------------------- | -------------------------------------------------- |
-| `npm run build:win`   | Build for Windows (`.exe` installer + portable)    |
-| `npm run build:mac`   | Build for macOS (`.dmg` + `.zip`)                  |
-| `npm run build:linux` | Build for Linux (`.AppImage` + `.deb` + `.tar.gz`) |
-| `npm run build:all`   | Build for all platforms                            |
+| Command                | Description                                        |
+| ---------------------- | -------------------------------------------------- |
+| `pnpm run build:win`   | Build for Windows (`.exe` installer + portable)    |
+| `pnpm run build:mac`   | Build for macOS (`.dmg` + `.zip`)                  |
+| `pnpm run build:linux` | Build for Linux (`.AppImage` + `.deb` + `.tar.gz`) |
+| `pnpm run build:all`   | Build for all platforms                            |
 
 ### Utilities
 
-| Command                 | Description                   |
-| ----------------------- | ----------------------------- |
-| `npm run generate-icon` | Regenerate app icons from SVG |
+| Command                  | Description                   |
+| ------------------------ | ----------------------------- |
+| `pnpm run generate-icon` | Regenerate app icons from SVG |
 
 ---
 
@@ -225,16 +225,16 @@ See detailed OAuth setup guide in the [Google Sign-In Setup](#google-sign-in-set
 
 ```bash
 # Windows
-npm run build:win
+pnpm run build:win
 
 # macOS
-npm run build:mac
+pnpm run build:mac
 
 # Linux
-npm run build:linux
+pnpm run build:linux
 
 # All platforms (requires cross-compilation setup)
-npm run build:all
+pnpm run build:all
 ```
 
 **Output files are saved to the `release/` directory:**
@@ -269,7 +269,7 @@ npm run build:all
 
 4. **Build and publish:**
    ```bash
-   npm run release
+   pnpm run release
    ```
 
 ### Cross-Platform Building Notes

SECURITY.md

@@ -117,9 +117,9 @@ Security patches will be released as soon as possible after a vulnerability is c
 
 ## Third-Party Dependencies
 
-This project depends on several npm packages. We recommend:
+This project depends on several packages. We recommend:
 
-- Running `npm audit` regularly to check for vulnerabilities
+- Running `pnpm audit` regularly to check for vulnerabilities
 - Keeping dependencies updated
 - Reviewing dependency changes before updating
 

electron/controllers/firebaseController.js

@@ -29,8 +29,12 @@ function setConnectionChangeCallback(callback) {
  */
 function registerHandlers() {
   // Connect to Firebase with service account
-  ipcMain.handle('firebase:connect', async (event, serviceAccountPath) => {
+  ipcMain.handle('firebase:connect', async (event, params) => {
     try {
+      // Support both object params and legacy string path
+      const serviceAccountPath = typeof params === 'string' ? params : params.serviceAccountPath;
+      const databaseId = typeof params === 'string' ? undefined : params.databaseId;
+
       if (admin) {
         await admin.app().delete();
       }
@@ -44,12 +48,16 @@ function registerHandlers() {
 
       db = admin.firestore();
 
+      if (databaseId) {
+        db.settings({ databaseId });
+      }
+
       // Notify other controllers about the connection change
       if (onConnectionChange) {
         onConnectionChange(admin, db);
       }
 
-      return { success: true, projectId: serviceAccount.project_id };
+      return { success: true, projectId: serviceAccount.project_id, databaseId };
     } catch (error) {
       return { success: false, error: error.message };
     }