fix: Event not presented to client when __type is missing in LiveQuery server response

[ashish-naik]

• [ x] I am not disclosing a vulnerability.
• [ x] I am creating this PR in reference to an issue 1832.

Issue Description

Response from websocket server does not include "__type":"Object" but PFDecoder expects this otherwise events failed to be caught.

Closes: Issue #1832

Approach

LiveryQuery server response sends data or events in "object":jsonf= format but PFDecoder.m checks for __type key which is missing as shown in below example so this fix will add "__type ":"Object" key-value if dictionary has className and objectId representing PFObject.

"object":{ "desc": "Technology", "createdAt": "2020-10-03T19:34:16.823Z", "updatedAt": "2025-09-27T17:55:02.360Z", "image_name": "technology.png", "className": "categories", "objectId": "kHnBntWHHW" }, "original": { "desc": "Technologyy", "createdAt": "2020-10-03T19:34:16.823Z", "updatedAt": "2025-09-27T17:54:10.800Z", "image_name": "technology.png", "className": "categories", "objectId": "kHnBntWHHW" } 

Requesting review.

• Add tests - I am not able to run tests on local.
• Add changes to documentation (guides, repository pages, in-code descriptions)

Summary by CodeRabbit

• Bug Fixes

  • Improved handling of objects missing explicit type metadata to reduce failed parses and ensure data loads more reliably.
  • Adjusted LiveQuery delivery to avoid decoding failures that could interrupt real-time updates, improving update stability.

• Refactor

  • Simplified internal decoding paths to increase consistency and maintainability without changing public APIs.

[parse-github-assistant]

🚀 Thanks for opening this pull request!

[coderabbitai]

📝 Walkthrough

Walkthrough

Injects "__type":"Object" into dictionaries missing __type when className and objectId exist so they follow the Object decoding path in PFDecoder. Separately, removes the live-query client path that decoded validated object dictionaries into a strongly-typed generic T and returned it.

Changes

Cohort / File(s)	Summary
Decoder: Inject __type for objects Parse/Parse/Source/PFDecoder.m	In decodeDictionary:, when __type is absent but both className and objectId are present, make a mutable copy, set __type = "Object", update the local type value, and continue through the existing Object-decoding branch. Other type branches and error handling unchanged.
LiveQuery: Remove typed object decoding ParseLiveQuery/ParseLiveQuery/Internal/ClientPrivate.swift	Removed the code that decoded the validated object dictionary into a strongly-typed T via PFDecoder.object().decode(...) as? T and the associated error/return path; precondition checks for className and objectId remain.

Sequence Diagram(s)

sequenceDiagram autonumber participant Caller as Caller participant PFDecoder as PFDecoder.decodeDictionary participant ObjBranch as Object Branch participant PFObject as PFObject Caller->>PFDecoder: decodeDictionary(data) alt __type missing AND className & objectId present note right of PFDecoder #DDEBF7: Inject "__type":"Object" into mutable copy PFDecoder->>ObjBranch: route with type="Object" else __type present PFDecoder->>ObjBranch: route based on __type end ObjBranch->>PFDecoder: recursively decode remaining fields ObjBranch->>PFObject: construct with defaultClassName, objectId, data PFDecoder-->>Caller: decoded PFObject 

Loading

sequenceDiagram autonumber participant Server as Server Event participant ClientBefore as LiveQuery Client (before) participant Decoder as PFDecoder.object() participant App as App Code Server-->>ClientBefore: object dictionary (className, objectId, fields) ClientBefore->>ClientBefore: validate className & objectId ClientBefore->>Decoder: decode(...) as T alt success ClientBefore-->>App: return T else failure ClientBefore-->>App: throw decoding error end 

Loading

sequenceDiagram autonumber participant Server as Server Event participant ClientNow as LiveQuery Client (now) participant App as App Code Server-->>ClientNow: object dictionary (className, objectId, fields) ClientNow->>ClientNow: validate className & objectId note right of ClientNow #F7F3E8: Typed decoding step removed ClientNow-->>App: proceed without returning typed T here 

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	The pull request description includes the vulnerability checklist, references the related issue, a clear issue description with example payload, an explicit "Closes" line, an approach section detailing the change logic, and pending TODOs for tests and documentation, covering all major template requirements despite missing one heading.
Docstring Coverage	✅ Passed	No functions found in the changes. Docstring coverage check skipped.
Title Check	✅ Passed	The title succinctly describes the core fix implemented in this PR—addressing the missing “__type” field in LiveQuery server responses that prevented events from being presented to the client—making it clear and directly related to the changeset’s purpose. It avoids unnecessary details or noise and follows conventional commit formatting without losing clarity.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[parseplatformorg]

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

✅ security/snyk check is complete. No issues have been found. (View Details)

[coderabbitai]

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 6cfad53 and eeebc5b.

📒 Files selected for processing (2)

• Parse/Parse/Source/PFDecoder.m (1 hunks)
• ParseLiveQuery/ParseLiveQuery/Internal/ClientPrivate.swift (0 hunks)

💤 Files with no reviewable changes (1)

• ParseLiveQuery/ParseLiveQuery/Internal/ClientPrivate.swift

[ashish-naik]

@mtrezza could you please review this?