Skip to content

Conversation

@Moumouls
Copy link
Member

@Moumouls Moumouls commented Nov 22, 2025

Pull Request

Issue

Closes: #9913

Approach

Some tests needed to be migrated to fetch, because they worked before by luck because of the indirect installation of "request" package

Tasks

  • Add tests
  • Add changes to documentation (guides, repository pages, code comments)

Summary by CodeRabbit

  • Dependencies

    • Bumped push adapter to v8.0.1
  • Updates

    • Android push now expects Firebase service-account-style credentials instead of legacy senderId/apiKey
  • Documentation

    • README formatting standardized: emphasis, tables, code quoting, punctuation, and examples
  • Tests

    • Test helpers converted to async fetch-style with improved error handling and control flow

✏️ Tip: You can customize this high-level summary in your review settings.

@parse-github-assistant
Copy link

I will reformat the title to use the proper commit message syntax.

@parse-github-assistant parse-github-assistant bot changed the title feat: update @parse/push-adapter to 7.0 feat: Update @parse/push-adapter to 7.0 Nov 22, 2025
@parse-github-assistant
Copy link

parse-github-assistant bot commented Nov 22, 2025

🚀 Thanks for opening this pull request!

@coderabbitai
Copy link

coderabbitai bot commented Nov 22, 2025

📝 Walkthrough

Walkthrough

Reformats README, replaces Android push senderId/apiKey with a nested firebaseServiceAccount in tests/helpers, converts callback HTTP test helpers to async fetch, bumps @parse/push-adapter in package.json, and updates a PushAdapter comment; no public API changes.

Changes

Cohort / File(s) Change Summary
Dependency Update
package.json
Bumps @parse/push-adapter from 6.11.0 to 8.0.1.
Documentation Cosmetic Edits
README.md
Styling and formatting changes across headings, emphasis, tables, code samples, quoting, trailing commas, punctuation/spacing, and note block formatting; no functional changes.
Push Adapter Configuration (tests & helpers)
spec/AdapterLoader.spec.js, spec/helper.js
Replaces Android push config fields senderId/apiKey with a nested firebaseServiceAccount object containing full service account fields (type, project_id, private_key_id, private_key, client_email, client_id, auth_uri, token_uri, auth_provider_x509_cert_url, client_x509_cert_url, universe_domain).
Test HTTP Helper Refactor
spec/ParseLiveQueryServer.spec.js
Converts callback-based HTTP helpers to async fetch: setPermissionsOnClass now awaits fetch, uses PUT for updates (POST otherwise), sends JSON body with classLevelPermissions, sets Content-Type: application/json, parses JSON response, and throws on API errors; minor arrow-function formatting tweak.
Source Comment Update
src/Adapters/Push/PushAdapter.js
Comment updated to indicate the default PushAdapter uses FCM for Android instead of GCM (comment-only change).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

  • Inspect spec/helper.js and spec/AdapterLoader.spec.js for correct structure and escaping of firebaseServiceAccount.private_key (preserve newlines and quoting).
  • Verify spec/ParseLiveQueryServer.spec.js async fetch changes preserve test timing, error propagation, and teardown behavior.
  • Confirm the @parse/push-adapter@8.0.1 upgrade aligns with the updated firebaseServiceAccount configuration shape.

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)
Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. You can run @coderabbitai generate docstrings to improve docstring coverage.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The PR title accurately reflects the main change: upgrading @parse/push-adapter from 6.11.0 to 8.0.1, which is clearly summarized and specific.
Description check ✅ Passed The PR description follows the template structure with issue link (#9913), approach explanation, and task completion checkboxes marked appropriately.
Linked Issues check ✅ Passed The PR successfully addresses the push adapter upgrade objective from #9913, upgrading to version 8.0.1 and migrating tests to fetch API as required.
Out of Scope Changes check ✅ Passed All changes are scoped to the push adapter upgrade and related test migrations; documentation and comment updates are consistent with the upgrade objectives.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 975fecf and b517232.

⛔ Files ignored due to path filters (1)
  • package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (1)
  • package.json (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • package.json

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@parseplatformorg
Copy link
Contributor

parseplatformorg commented Nov 22, 2025

Snyk checks have passed. No issues have been found so far.

Status Scanner Critical High Medium Low Total (0)
Open Source Security 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 9ed9af4 and ea4508f.

⛔ Files ignored due to path filters (1)
  • package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (6)
  • README.md (34 hunks)
  • package.json (1 hunks)
  • spec/AdapterLoader.spec.js (1 hunks)
  • spec/ParseLiveQueryServer.spec.js (3 hunks)
  • spec/helper.js (1 hunks)
  • src/Adapters/Push/PushAdapter.js (1 hunks)
🧰 Additional context used
🧠 Learnings (12)
📓 Common learnings
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-17T15:02:48.786Z
Learning: For Parse Server PRs, always suggest an Angular commit convention PR title that would make a meaningful changelog entry for developers. Update the PR title suggestion on every commit. The format should be: type(scope): description. Common types include feat, fix, perf, refactor, docs, test, chore. The scope should identify the subsystem (e.g., graphql, rest, push, security). The description should be action-oriented and clearly convey the change's impact to developers.
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-08T13:46:04.940Z
Learning: When reviewing Parse Server PRs that add new features, always check whether the feature is documented in the README.md file, though for new Parse Server options this is optional rather than required.
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-17T15:02:24.824Z
Learning: For Parse Server PRs, always suggest an Angular-style PR title that would make a meaningful changelog entry for developers. Update the PR title suggestion with every new commit to the PR.
📚 Learning: 2025-04-30T19:31:35.344Z
Learnt from: RahulLanjewar93
Repo: parse-community/parse-server PR: 9744
File: spec/ParseLiveQuery.spec.js:0-0
Timestamp: 2025-04-30T19:31:35.344Z
Learning: In the Parse Server codebase, the functions in QueryTools.js are typically tested through end-to-end behavior tests rather than direct unit tests, even though the functions are exported from the module.

Applied to files:

  • package.json
  • spec/ParseLiveQueryServer.spec.js
📚 Learning: 2025-11-17T15:02:48.786Z
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-17T15:02:48.786Z
Learning: For Parse Server PRs, always suggest an Angular commit convention PR title that would make a meaningful changelog entry for developers. Update the PR title suggestion on every commit. The format should be: type(scope): description. Common types include feat, fix, perf, refactor, docs, test, chore. The scope should identify the subsystem (e.g., graphql, rest, push, security). The description should be action-oriented and clearly convey the change's impact to developers.

Applied to files:

  • README.md
📚 Learning: 2025-11-08T13:46:04.940Z
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-08T13:46:04.940Z
Learning: For new Parse Server options, verify that the option is documented in src/Options/index.js and that npm run definitions has been executed to reflect changes in src/Options/docs.js and src/Options/Definitions.js. README.md documentation is a bonus but not required for new options.

Applied to files:

  • README.md
📚 Learning: 2025-09-21T15:43:32.265Z
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 9858
File: src/GraphQL/ParseGraphQLServer.js:176-178
Timestamp: 2025-09-21T15:43:32.265Z
Learning: The GraphQL playground feature in ParseGraphQLServer.js (applyPlayground method) is intended for development environments only, which is why it includes the master key in client-side headers.

Applied to files:

  • README.md
📚 Learning: 2025-11-08T13:46:04.940Z
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-08T13:46:04.940Z
Learning: When reviewing Parse Server PRs that add new features, always check whether the feature is documented in the README.md file, though for new Parse Server options this is optional rather than required.

Applied to files:

  • README.md
📚 Learning: 2025-11-17T15:02:24.824Z
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-17T15:02:24.824Z
Learning: For Parse Server PRs, always suggest an Angular-style PR title that would make a meaningful changelog entry for developers. Update the PR title suggestion with every new commit to the PR.

Applied to files:

  • README.md
📚 Learning: 2025-05-04T20:41:05.147Z
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 9445
File: spec/ParseLiveQuery.spec.js:1312-1338
Timestamp: 2025-05-04T20:41:05.147Z
Learning: New tests in the parse-server repository should use async/await with promise-based patterns rather than callback patterns with `done()`.

Applied to files:

  • spec/ParseLiveQueryServer.spec.js
📚 Learning: 2025-05-09T09:59:06.289Z
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 9445
File: spec/ParseLiveQuery.spec.js:1340-1375
Timestamp: 2025-05-09T09:59:06.289Z
Learning: New tests in the parse-server repository should use async/await with promise-based patterns rather than callback patterns with `done()`. The preferred pattern is to create a Promise that resolves when an expected event occurs, then await that Promise.

Applied to files:

  • spec/ParseLiveQueryServer.spec.js
📚 Learning: 2025-05-09T09:59:06.289Z
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 9445
File: spec/ParseLiveQuery.spec.js:1340-1375
Timestamp: 2025-05-09T09:59:06.289Z
Learning: Tests in the parse-server repository should use promise-based approaches rather than callback patterns with `done()`. Use a pattern where a Promise is created that resolves when the event occurs, then await that promise.

Applied to files:

  • spec/ParseLiveQueryServer.spec.js
📚 Learning: 2025-10-16T19:27:05.311Z
Learnt from: Moumouls
Repo: parse-community/parse-server PR: 9883
File: spec/CloudCodeLogger.spec.js:410-412
Timestamp: 2025-10-16T19:27:05.311Z
Learning: In spec/CloudCodeLogger.spec.js, the test "should log cloud function triggers using the silent log level" (around lines 383-420) is known to be flaky and requires the extra `await new Promise(resolve => setTimeout(resolve, 100))` timeout after awaiting `afterSavePromise` for reliability, even though it may appear redundant.

Applied to files:

  • spec/ParseLiveQueryServer.spec.js
📚 Learning: 2025-08-27T09:08:34.252Z
Learnt from: EmpiDev
Repo: parse-community/parse-server PR: 9770
File: src/triggers.js:446-454
Timestamp: 2025-08-27T09:08:34.252Z
Learning: When analyzing function signature changes in Parse Server codebase, verify that call sites are actually incorrect before flagging them. Passing tests are a strong indicator that function calls are already properly aligned with new signatures.

Applied to files:

  • spec/ParseLiveQueryServer.spec.js
🧬 Code graph analysis (1)
spec/ParseLiveQueryServer.spec.js (1)
spec/ParseGraphQLServer.spec.js (1)
  • fetch (4-4)
🪛 Gitleaks (8.29.0)
spec/AdapterLoader.spec.js

[high] 112-112: Identified a Private Key, which may compromise cryptographic security and sensitive data encryption.

(private-key)

spec/helper.js

[high] 143-143: Identified a Private Key, which may compromise cryptographic security and sensitive data encryption.

(private-key)

🪛 LanguageTool
README.md

[grammar] ~331-~331: Ensure spelling is correct
Context: ...ailAdapterOptions, }, }, }); ``` Offical email adapters maintained by Parse Plat...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)


[grammar] ~772-~772: Use a hyphen to join words.
Context: ...Y --logLevel LOG_LEVEL` **Want new line delimited JSON error logs (for consumpti...

(QB_NEW_EN_HYPHEN)


[style] ~772-~772: In American English, abbreviations like “etc.” require a period.
Context: ...on by CloudWatch, Google Cloud Logging, etc)?** Pass the JSON_LOGS environment va...

(ETC_PERIOD)

🪛 markdownlint-cli2 (0.18.1)
README.md

189-189: Link text should be descriptive

(MD059, descriptive-link-text)


823-823: Bare URL used

(MD034, no-bare-urls)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (15)
  • GitHub Check: PostgreSQL 18, PostGIS 3.6
  • GitHub Check: MongoDB 6, ReplicaSet
  • GitHub Check: PostgreSQL 16, PostGIS 3.5
  • GitHub Check: PostgreSQL 17, PostGIS 3.5
  • GitHub Check: Node 20
  • GitHub Check: MongoDB 8, ReplicaSet
  • GitHub Check: PostgreSQL 15, PostGIS 3.5
  • GitHub Check: Node 22
  • GitHub Check: PostgreSQL 15, PostGIS 3.4
  • GitHub Check: Docker Build
  • GitHub Check: Node 18
  • GitHub Check: Redis Cache
  • GitHub Check: PostgreSQL 15, PostGIS 3.3
  • GitHub Check: MongoDB 7, ReplicaSet
  • GitHub Check: Benchmarks
🔇 Additional comments (6)
src/Adapters/Push/PushAdapter.js (1)

11-12: Documentation accurately updated.

The comment correctly reflects that FCM (Firebase Cloud Messaging) is now used instead of the deprecated GCM (Google Cloud Messaging). This aligns with the push adapter upgrade.

spec/ParseLiveQueryServer.spec.js (2)

157-175: LGTM! Test helper modernized to async/await.

The refactoring from callback-based HTTP requests to async fetch with proper error handling aligns with modern testing practices. The function correctly:

  • Uses async/await instead of callbacks
  • Determines HTTP method (PUT for updates, POST otherwise)
  • Includes proper headers and JSON body
  • Handles errors appropriately

Based on learnings: New tests in Parse Server should use async/await patterns.


632-632: Minor formatting improvement.

The empty function body is now consistently formatted.

README.md (1)

1-1154: Documentation formatting improvements.

The README updates are purely cosmetic, improving consistency in:

  • Emphasis styling
  • Table formatting
  • Code sample formatting
  • Punctuation and spacing

No functional documentation changes detected.

spec/helper.js (1)

139-152: Default test configuration updated consistently.

The default test configuration now uses the new firebaseServiceAccount structure, ensuring all tests that rely on defaultConfiguration will use the correct format for @parse/push-adapter 7.0.

This change is consistent with the update in spec/AdapterLoader.spec.js.

Note: The Gitleaks warning about the private key on line 143 is expected—this is mock test data shared across test files.

package.json (1)

29-29: Verify implementation aligns with @parse/push-adapter 7.0.0 breaking changes and update PR title.

The 7.0.0 release includes a breaking change: removal of Google Cloud Messaging (GCM) API and migration to FCM HTTP v1 API, requiring a service account JSON instead of the legacy apiKey. Your configuration shift claim is verified as accurate. The codebase specs already reference the correct firebaseServiceAccount structure, but verify that all implementation code properly supports this migration (e.g., authentication flows, error handling, legacy API references removed).

Consider updating the PR title to clearly signal the breaking change per Angular convention:

feat(push)!: upgrade to @parse/push-adapter 7.0 with FCM HTTP v1 migration

The ! denotes a breaking change and the description conveys the impact to users who must migrate authentication.

Comment on lines +108 to 121
firebaseServiceAccount: {
"type": "service_account",
"project_id": "example-xxxx",
"private_key_id": "xxxx",
"private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCxFcVMD9L2xJWW\nEMi4w/XIBPvX5bTStIEdt4GY+yfrmCHspaVdgpTcHlTLA60sAGTFdorPprOwAm6f\njaTG4j86zfW25GF6AlFO/8vE2B0tjreuQQtcP9gkWJmsTp8yzXDirDQ43Kv93Kbc\nUPmsyAN5WB8XiFjjWLnFCeDiOVdd8sHfG0HYldNzyYwXrOTLE5kOjASYSJDzdrfI\nwN9PzZC7+cCy/DDzTRKQCqfz9pEZmxqJk4Id5HLVNkGKgji3C3b6o3MXWPS+1+zD\nGheKC9WLDZnCVycAnNHFiPpsp7R82lLKC3Dth37b6qzJO+HwfTmzCb0/xCVJ0/mZ\nC4Mxih/bAgMBAAECggEACbL1DvDw75Yd0U3TCJenDxEC0DTjHgVH6x5BaWUcLyGy\nffkmoQQFbjb1Evd9FSNiYZRYDv6E6feAIpoJ8+CxcOGV+zHwCtQ0qtyExx/FHVkr\nQ06JtkBC8N6vcAoQWyJ4c9nVtGWVv/5FX1zKCAYedpd2gH31zGHwLtQXLpzQZbNO\nO/0rcggg4unGSUIyw5437XiyckJ3QdneSEPe9HvY2wxLn/f1PjMpRYiNLBSuaFBJ\n+MYXr//Vh7cMInQk5/pMFbGxugNb7dtjgvm3LKRssKnubEOyrKldo8DVJmAvjhP4\nWboOOBVEo2ZhXgnBjeMvI8btXlJ85h9lZ7xwqfWsjQKBgQDkrrLpA3Mm21rsP1Ar\nMLEnYTdMZ7k+FTm5pJffPOsC7wiLWdRLwwrtb0V3kC3jr2K4SZY/OEV8IAWHfut/\n8mP8cPQPJiFp92iOgde4Xq/Ycwx4ZAXUj7mHHgywFi2K0xATzgc9sgX3NCVl9utR\nIU/FbEDCLxyD4T3Jb5gL3xFdhwKBgQDGPS46AiHuYmV7OG4gEOsNdczTppBJCgTt\nKGSJOxZg8sQodNJeWTPP2iQr4yJ4EY57NQmH7WSogLrGj8tmorEaL7I2kYlHJzGm\nniwApWEZlFc00xgXwV5d8ATfmAf8W1ZSZ6THbHesDUGjXSoL95k3KKXhnztjUT6I\n8d5qkCygDQKBgFN7p1rDZKVZzO6UCntJ8lJS/jIJZ6nPa9xmxv67KXxPsQnWSFdE\nI9gcF/sXCnmlTF/ElXIM4+j1c69MWULDRVciESb6n5YkuOnVYuAuyPk2vuWwdiRs\nN6mpAa7C2etlM+hW/XO7aswdIE4B/1QF2i5TX6zEMB/A+aJw98vVqmw/AoGADOm9\nUiADb9DPBXjGi6YueYD756mI6okRixU/f0TvDz+hEXWSonyzCE4QXx97hlC2dEYf\nKdCH5wYDpJ2HRVdBrBABTtaqF41xCYZyHVSof48PIyzA/AMnj3zsBFiV5JVaiSGh\nNTBWl0mBxg9yhrcJLvOh4pGJv81yAl+m+lAL6B0CgYEArtqtQ1YVLIUn4Pb/HDn8\nN8o7WbhloWQnG34iSsAG8yNtzbbxdugFrEm5ejPSgZ+dbzSzi/hizOFS/+/fwEdl\nay9jqY1fngoqSrS8eddUsY1/WAcmd6wPWEamsSjazA4uxQERruuFOi94E4b895KA\nqYe0A3xb0JL2ieAOZsn8XNA=\n-----END PRIVATE KEY-----\n",
"client_email": "test@example.com",
"client_id": "1",
"auth_uri": "https://example.com",
"token_uri": "https://example.com",
"auth_provider_x509_cert_url": "https://example.com",
"client_x509_cert_url": "https://example.com",
"universe_domain": "example.com"
}
},
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

Breaking change: verify migration documentation exists.

The Android push configuration has changed from a simple senderId/apiKey structure to requiring a complete Firebase service account JSON object. This is a breaking change that will require all Parse Server users with Android push configured to update their configuration.

Ensure that:

  1. Migration documentation exists explaining how users obtain their Firebase service account JSON
  2. The changelog clearly marks this as a BREAKING CHANGE
  3. The Parse Server upgrade guide includes this migration step

Note: The Gitleaks warning about the private key on line 112 is expected—this is mock test data, not a real credential.


🌐 Web query:

Where can users find documentation on obtaining a Firebase service account JSON file for Parse Server push notifications?

💡 Result:

You can find step‑by‑step instructions in the Firebase docs (generate a service account JSON under Project settings → Service accounts / “Generate new private key”). (firebase.google.com)

Parse Server’s push documentation and its push‑adapter README also reference using that Firebase service account JSON (firebaseServiceAccount / path) for FCM configuration. (github.com)

Citations:



---

🏁 Script executed:

```shell
#!/bin/bash
# Search for changelog entries about Android push configuration breaking change
find . -type f -name "CHANGELOG*" -o -name "changelog*" -o -name "HISTORY*" | head -20

Length of output: 124


🏁 Script executed:

#!/bin/bash
# Search for upgrade guide or migration documentation
find . -type f \( -name "*UPGRADE*" -o -name "*upgrade*" -o -name "*MIGRATION*" -o -name "*migration*" \) -type f | head -20

Length of output: 0


🏁 Script executed:

#!/bin/bash
# Check push-adapter references in documentation
rg -i "firebaseServiceAccount|firebase.*service.*account" --type=md -A 2 -B 2 | head -100

Length of output: 0


🏁 Script executed:

#!/bin/bash
# Search for references to Android push or FCM configuration changes
rg -i "android.*push|fcm.*config|breaking.*change" --type=md | head -50

Length of output: 9400


🏁 Script executed:

#!/bin/bash
# Check README for push configuration documentation
rg -i "push.*notification|firebase.*account" README.md -A 3 -B 1 | head -60

Length of output: 269



---

🏁 Script executed:

```shell
#!/bin/bash
# Search all changelogs for push-adapter or FCM breaking changes
rg -i "push-adapter|@parse/push|fcm|firebase" ./CHANGELOG.md ./changelogs/ -A 2 -B 1 | head -150

Length of output: 9895


🏁 Script executed:

#!/bin/bash
# Check DEPRECATIONS.md for any push-related deprecations
cat DEPRECATIONS.md | head -100

Length of output: 4791


🏁 Script executed:

#!/bin/bash
# Look at the test file to understand what change is being tested
cat spec/AdapterLoader.spec.js | grep -A 30 -B 5 "firebaseServiceAccount" | head -80

Length of output: 2928


🏁 Script executed:

#!/bin/bash
# Search for any documentation about push configuration in docs or guides
find . -type f -name "*.md" -exec grep -l "push.*configuration\|android.*push" {} \; | head -20

Length of output: 0



---

🏁 Script executed:

```shell
#!/bin/bash
# Check package.json for push-adapter version
grep -A 2 -B 2 "parse/push-adapter\|push-adapter" package.json

Length of output: 165


🏁 Script executed:

#!/bin/bash
# Search README for any push configuration guidance
grep -n -i "push\|fcm\|android" README.md | head -30

Length of output: 184


🏁 Script executed:

#!/bin/bash
# Search for any docs folder with push documentation
find . -type f -name "*.md" -path "*/doc*" -o -path "*/guide*" 2>/dev/null | head -20

Length of output: 0


🏁 Script executed:

#!/bin/bash
# Check if there's any migration info in the push adapter options/config documentation
find . -type f -name "*.md" | xargs grep -l "firebaseServiceAccount" 2>/dev/null

Length of output: 0


Breaking change in push-adapter 7.0.0 lacks adequate migration documentation in Parse Server.

The test confirms that Parse Server now uses @parse/push-adapter 7.0.0, which introduces a breaking change to Android push configuration (from simple senderId/apiKey to full Firebase service account JSON). However, Parse Server's own documentation does not guide users through this migration:

  • README.md only links generically to external "Push Notifications quick start" without explaining the configuration change
  • CHANGELOG/changelogs do not explicitly mark the push-adapter 7.0.0 upgrade as a BREAKING CHANGE
  • No migration or upgrade guide exists in the repository

Users upgrading Parse Server to versions that include push-adapter 7.0.0 will encounter configuration errors without guidance. Parse Server should add to README.md or create an upgrade guide explaining:

  1. The configuration change (old vs new format)
  2. How to obtain Firebase service account JSON
  3. Migration steps for existing deployments
🧰 Tools
🪛 Gitleaks (8.29.0)

[high] 112-112: Identified a Private Key, which may compromise cryptographic security and sensitive data encryption.

(private-key)

🤖 Prompt for AI Agents
In spec/AdapterLoader.spec.js around lines 108 to 121, the test and review point
out that the upgrade to @parse/push-adapter 7.0.0 is a breaking change (Android
push config moved from senderId/apiKey to full Firebase service account JSON)
but the repo lacks migration docs; update the repository documentation by adding
a clear upgrade note and migration guide: modify README.md (or add
docs/upgrading/push-adapter-7.md) to explicitly document the old vs new
configuration formats, step-by-step instructions to obtain a Firebase service
account JSON, and example migration steps for existing Parse Server deployments,
and update the CHANGELOG to mark push-adapter 7.0.0 as a BREAKING CHANGE
referencing the new docs.

@codecov
Copy link

codecov bot commented Nov 22, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.58%. Comparing base (3ca85cd) to head (b517232).
⚠️ Report is 1 commits behind head on alpha.

Additional details and impacted files
@@           Coverage Diff           @@
##            alpha    #9938   +/-   ##
=======================================
  Coverage   92.58%   92.58%           
=======================================
  Files         191      191           
  Lines       15544    15544           
  Branches      177      177           
=======================================
  Hits        14391    14391           
  Misses       1141     1141           
  Partials       12       12           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@mtrezza mtrezza added the state:breaking Breaking change requires major version increment and `BREAKING CHANGE` commit message label Nov 22, 2025
@mtrezza mtrezza mentioned this pull request Nov 22, 2025
23 tasks
@mtrezza mtrezza closed this Dec 1, 2025
@mtrezza mtrezza reopened this Dec 1, 2025
@mtrezza
Copy link
Member

mtrezza commented Dec 1, 2025

Requires upgrade to push adapter 8.x which drops support for Node 18.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
package.json (1)

1-174: Suggest Angular commit convention for PR title.

Based on learnings from recent Parse Server reviews, consider updating the PR title to follow Angular commit conventions for a meaningful changelog entry. Current title: feat: Update @parse/push-adapter to 7.0.

Suggested format:

  • feat(push): update @parse/push-adapter to 7.0.0 (if the primary focus is the feature/update)
  • Or, if this is more of a breaking change/migration: chore(push)!: migrate @parse/push-adapter to 7.0.0 (the ! indicates a breaking change)

The scope (push) identifies the subsystem, and the description should be action-oriented. The breaking change indicator (!) may be preferred given the "state:breaking" label.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 3df983b and 0065aac.

⛔ Files ignored due to path filters (1)
  • package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (1)
  • package.json (1 hunks)
🧰 Additional context used
🧠 Learnings (2)
📓 Common learnings
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-17T15:02:48.786Z
Learning: For Parse Server PRs, always suggest an Angular commit convention PR title that would make a meaningful changelog entry for developers. Update the PR title suggestion on every commit. The format should be: type(scope): description. Common types include feat, fix, perf, refactor, docs, test, chore. The scope should identify the subsystem (e.g., graphql, rest, push, security). The description should be action-oriented and clearly convey the change's impact to developers.
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-08T13:46:04.940Z
Learning: When reviewing Parse Server PRs that add new features, always check whether the feature is documented in the README.md file, though for new Parse Server options this is optional rather than required.
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-17T15:02:24.824Z
Learning: For Parse Server PRs, always suggest an Angular-style PR title that would make a meaningful changelog entry for developers. Update the PR title suggestion with every new commit to the PR.
📚 Learning: 2025-04-30T19:31:35.344Z
Learnt from: RahulLanjewar93
Repo: parse-community/parse-server PR: 9744
File: spec/ParseLiveQuery.spec.js:0-0
Timestamp: 2025-04-30T19:31:35.344Z
Learning: In the Parse Server codebase, the functions in QueryTools.js are typically tested through end-to-end behavior tests rather than direct unit tests, even though the functions are exported from the module.

Applied to files:

  • package.json

package.json Outdated
"@graphql-tools/utils": "10.8.6",
"@parse/fs-files-adapter": "3.0.0",
"@parse/push-adapter": "6.11.0",
"@parse/push-adapter": "7.0.0",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🌐 Web query:

@parse/push-adapter 7.0.0 release notes breaking changes

💡 Result:

@parse/push-adapter 7.0.0 — Breaking changes:

  • Removed Google Cloud Messaging (GCM) API (GCM was already out of service). [1][2]

Sources:
[1] @parse/push-adapter changelog (7.0.0).
[2] parse-server-push-adapter (project docs/README).


🏁 Script executed:

# Search for related test and config changes mentioned in the review
rg "firebaseServiceAccount|senderId|apiKey" --type json --type js -i

Repository: parse-community/parse-server

Length of output: 200


🏁 Script executed:

# Check if there are adapter-related changes in the PR context
git ls-files | head -20

Repository: parse-community/parse-server

Length of output: 200


Update dependency to @parse/push-adapter 7.0.0.

The major version bump introduces a breaking change: removal of Google Cloud Messaging (GCM) API support, which was already out of service. Ensure that no code in this project currently relies on GCM integration; if it does, alternative push notification methods should be configured before merging this change.

🤖 Prompt for AI Agents
In package.json at line 28, bumping @parse/push-adapter to 7.0.0 removes GCM
support; audit the codebase for any GCM-specific usage and replace or remove it
before merging. Search repository-wide for "gcm", "GCM",
"google-cloud-messaging", and any push-adapter initialization code that passes a
"gcm" config option or uses legacy GCM keys; update those integrations to use
FCM/APNs or the adapter's supported configuration keys, adjust tests/fixtures
that reference GCM, and run push integration/manual tests to confirm behavior;
if migration cannot be completed now, revert the dependency to the last 6.x
version until changes are made.

@mtrezza mtrezza changed the title feat: Update @parse/push-adapter to 7.0 feat: Upgrade to @parse/push-adapter 8.0.0 Dec 2, 2025
@mtrezza
Copy link
Member

mtrezza commented Dec 2, 2025

@coderabbitai make sure this PR upgrades to a push adapter version >= 8.

@coderabbitai
Copy link

coderabbitai bot commented Dec 2, 2025

Tip

For best results, initiate chat on the files or code changes.

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Check the current version of @parse/push-adapter in package.json
cat package.json | jq -r '.dependencies["@parse/push-adapter"]'

Length of output: 5


🏁 Script executed:

#!/bin/bash
# Check npm registry for available versions of @parse/push-adapter
npm view @parse/push-adapter versions --json | jq -r '.[-10:][]'

Length of output: 61


🏁 Script executed:

#!/bin/bash
# Check the latest version and tags
npm view @parse/push-adapter version
npm view @parse/push-adapter dist-tags --json

Length of output: 29


@mtrezza, I've checked the current state of this PR:

Current version: @parse/push-adapter: 7.0.0
Available version: 8.0.0 (latest on npm)

The PR currently upgrades to version 7.0.0, but version 8.0.0 is available and should be used instead. As you noted earlier, version 8.x drops support for Node 18, which aligns with the Parse Server 9 release objectives to remove support for EOL Node versions.

The upgrade to 8.0.0 would require updating package.json to use version 8.0.0 instead of 7.0.0.


✏️ Learnings added
Learnt from: mtrezza
URL: https://github.com/parse-community/parse-server/pull/9938

Timestamp: 2025-12-02T08:00:08.400Z
Learning: For Parse Server 9 release preparation, the parse/push-adapter dependency should be upgraded to version >= 8.0.0, not 7.x, as version 8.x is required despite dropping Node 18 support (which aligns with Parse Server 9's removal of EOL Node versions).

Note: Learnings are effective only in the context of similar code segments. To apply general coding guidelines, please configure review instructions. You can manage existing learnings in the app.


🧠 Learnings used
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-17T15:02:48.786Z
Learning: For Parse Server PRs, always suggest an Angular commit convention PR title that would make a meaningful changelog entry for developers. Update the PR title suggestion on every commit. The format should be: type(scope): description. Common types include feat, fix, perf, refactor, docs, test, chore. The scope should identify the subsystem (e.g., graphql, rest, push, security). The description should be action-oriented and clearly convey the change's impact to developers.

Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-08T13:46:04.940Z
Learning: When reviewing Parse Server PRs that add new features, always check whether the feature is documented in the README.md file, though for new Parse Server options this is optional rather than required.

Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-17T15:02:24.824Z
Learning: For Parse Server PRs, always suggest an Angular-style PR title that would make a meaningful changelog entry for developers. Update the PR title suggestion with every new commit to the PR.

@coderabbitai
Copy link

coderabbitai bot commented Dec 2, 2025

Tip

For best results, initiate chat on the files or code changes.

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Check the current version of @parse/push-adapter in package.json
cat package.json | jq '.dependencies["@parse/push-adapter"]'

# Check available versions of @parse/push-adapter on npm
npm view @parse/push-adapter versions --json | jq '.[-10:]'

# Check the latest version
npm view @parse/push-adapter version

Length of output: 128


@mtrezza, I've checked the current state of this PR:

Current Status:

  • This PR currently upgrades @parse/push-adapter to 7.0.0
  • The latest version available on npm is 8.0.0

Required Action:
The PR needs to be updated to upgrade to version 8.0.0 (or later) to meet your requirement. The package.json dependency needs to be changed from:

"@parse/push-adapter": "7.0.0"

to:

"@parse/push-adapter": "8.0.0"

As you mentioned earlier, version 8.x drops support for Node 18, so this upgrade will need to account for that breaking change as well.


✏️ Learnings added
Learnt from: mtrezza
URL: https://github.com/parse-community/parse-server/pull/9938

Timestamp: 2025-12-02T08:00:20.117Z
Learning: For Parse Server 9 release (PR #9938 and related), the parse/push-adapter dependency must be upgraded to version >= 8.0.0, not 7.0.0. Version 8.x drops support for Node 18.

Note: Learnings are effective only in the context of similar code segments. To apply general coding guidelines, please configure review instructions. You can manage existing learnings in the app.


🧠 Learnings used
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-17T15:02:48.786Z
Learning: For Parse Server PRs, always suggest an Angular commit convention PR title that would make a meaningful changelog entry for developers. Update the PR title suggestion on every commit. The format should be: type(scope): description. Common types include feat, fix, perf, refactor, docs, test, chore. The scope should identify the subsystem (e.g., graphql, rest, push, security). The description should be action-oriented and clearly convey the change's impact to developers.

Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-08T13:46:04.940Z
Learning: When reviewing Parse Server PRs that add new features, always check whether the feature is documented in the README.md file, though for new Parse Server options this is optional rather than required.

Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-17T15:02:24.824Z
Learning: For Parse Server PRs, always suggest an Angular-style PR title that would make a meaningful changelog entry for developers. Update the PR title suggestion with every new commit to the PR.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between f1d2316 and 975fecf.

⛔ Files ignored due to path filters (1)
  • package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (1)
  • package.json (1 hunks)
🧰 Additional context used
🧠 Learnings (8)
📓 Common learnings
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-12-02T08:00:20.138Z
Learning: For Parse Server 9 release (PR #9938 and related), the parse/push-adapter dependency must be upgraded to version >= 8.0.0, not 7.0.0. Version 8.x drops support for Node 18.
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-12-02T08:00:08.440Z
Learning: For Parse Server 9 release preparation, the parse/push-adapter dependency should be upgraded to version >= 8.0.0, not 7.x, as version 8.x is required despite dropping Node 18 support (which aligns with Parse Server 9's removal of EOL Node versions).
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-17T15:02:48.786Z
Learning: For Parse Server PRs, always suggest an Angular commit convention PR title that would make a meaningful changelog entry for developers. Update the PR title suggestion on every commit. The format should be: type(scope): description. Common types include feat, fix, perf, refactor, docs, test, chore. The scope should identify the subsystem (e.g., graphql, rest, push, security). The description should be action-oriented and clearly convey the change's impact to developers.
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-08T13:46:04.940Z
Learning: When reviewing Parse Server PRs that add new features, always check whether the feature is documented in the README.md file, though for new Parse Server options this is optional rather than required.
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-17T15:02:24.824Z
Learning: For Parse Server PRs, always suggest an Angular-style PR title that would make a meaningful changelog entry for developers. Update the PR title suggestion with every new commit to the PR.
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 9445
File: spec/ParseLiveQuery.spec.js:1312-1338
Timestamp: 2025-05-04T20:41:05.147Z
Learning: New tests in the parse-server repository should use async/await with promise-based patterns rather than callback patterns with `done()`.
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 9445
File: spec/ParseLiveQuery.spec.js:1340-1375
Timestamp: 2025-05-09T09:59:06.289Z
Learning: New tests in the parse-server repository should use async/await with promise-based patterns rather than callback patterns with `done()`. The preferred pattern is to create a Promise that resolves when an expected event occurs, then await that Promise.
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 9445
File: spec/ParseLiveQuery.spec.js:1340-1375
Timestamp: 2025-05-09T09:59:06.289Z
Learning: Tests in the parse-server repository should use promise-based approaches rather than callback patterns with `done()`. Use a pattern where a Promise is created that resolves when the event occurs, then await that promise.
📚 Learning: 2025-12-02T08:00:20.138Z
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-12-02T08:00:20.138Z
Learning: For Parse Server 9 release (PR #9938 and related), the parse/push-adapter dependency must be upgraded to version >= 8.0.0, not 7.0.0. Version 8.x drops support for Node 18.

Applied to files:

  • package.json
📚 Learning: 2025-12-02T08:00:08.440Z
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-12-02T08:00:08.440Z
Learning: For Parse Server 9 release preparation, the parse/push-adapter dependency should be upgraded to version >= 8.0.0, not 7.x, as version 8.x is required despite dropping Node 18 support (which aligns with Parse Server 9's removal of EOL Node versions).

Applied to files:

  • package.json
📚 Learning: 2025-11-17T15:02:24.824Z
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-17T15:02:24.824Z
Learning: For Parse Server PRs, always suggest an Angular-style PR title that would make a meaningful changelog entry for developers. Update the PR title suggestion with every new commit to the PR.

Applied to files:

  • package.json
📚 Learning: 2025-11-17T15:02:48.786Z
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-17T15:02:48.786Z
Learning: For Parse Server PRs, always suggest an Angular commit convention PR title that would make a meaningful changelog entry for developers. Update the PR title suggestion on every commit. The format should be: type(scope): description. Common types include feat, fix, perf, refactor, docs, test, chore. The scope should identify the subsystem (e.g., graphql, rest, push, security). The description should be action-oriented and clearly convey the change's impact to developers.

Applied to files:

  • package.json
📚 Learning: 2025-11-08T13:46:04.940Z
Learnt from: mtrezza
Repo: parse-community/parse-server PR: 0
File: :0-0
Timestamp: 2025-11-08T13:46:04.940Z
Learning: When reviewing Parse Server PRs that add new features, always check whether the feature is documented in the README.md file, though for new Parse Server options this is optional rather than required.

Applied to files:

  • package.json
📚 Learning: 2025-08-27T09:08:34.252Z
Learnt from: EmpiDev
Repo: parse-community/parse-server PR: 9770
File: src/triggers.js:446-454
Timestamp: 2025-08-27T09:08:34.252Z
Learning: When analyzing function signature changes in Parse Server codebase, verify that call sites are actually incorrect before flagging them. Passing tests are a strong indicator that function calls are already properly aligned with new signatures.

Applied to files:

  • package.json
📚 Learning: 2025-04-30T19:31:35.344Z
Learnt from: RahulLanjewar93
Repo: parse-community/parse-server PR: 9744
File: spec/ParseLiveQuery.spec.js:0-0
Timestamp: 2025-04-30T19:31:35.344Z
Learning: In the Parse Server codebase, the functions in QueryTools.js are typically tested through end-to-end behavior tests rather than direct unit tests, even though the functions are exported from the module.

Applied to files:

  • package.json

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

state:breaking Breaking change requires major version increment and `BREAKING CHANGE` commit message

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Prepare release of Parse Server 9

3 participants