feat: implement findFirstMatchingKeyValue utility function

[huynguyen-hl]

What type of PR is this? (check all applicable)

• 🍕 Feature
• 🐛 Bug Fix
• 📝 Documentation Update
• 🎨 Style
• 🧑‍💻 Code Refactor
• 🔥 Performance Improvements
• ✅ Test
• 🤖 Build
• 🔁 CI
• 📦 Chore (Release)
• ⏩ Revert

Description

This PR aims to implement the findFirstMatchingKeyValue utility function, along with its documentation and example usage. The function recursively searches for a specific key within nested objects, enabling UNTP components to efficiently locate and extract values from deeply nested structures.

Related Tickets & Documents

https://github.com/gs-gs/fa-ag-trace/issues/917

Mobile & Desktop Screenshots/Recordings

• Configure the findFirstMatchingKeyValue utility function:

{
  "name": "findFirstMatchingKeyValue",
  "parameters": [
    {
      "targetKey": "credentialSubject"
    }
  ]
}

• Configure the BarcodeGenerator component:

{
  "name": "BarcodeGenerator",
  "type": "Result",
  "props": {
    "dataPath": {
      "primary": {
        "ai": "01",
        "path": "/registeredId"
      }
    }
  }
}

• Issue a new DPP using the BarcodeGenerator component and the getValueFromLocalStorage service together:

Added tests?

• 👍 yes
• 🙅 no, because they aren't needed
• 🙋 no, because I need help

Added to documentation?

• 📖 Mock App docs site
• 📜 README.md
• 📕 storybook
• 🙅 no documentation needed

[github-actions]

Code Coverage Report

Lines	Statements	Branches	Functions
	81.28% (3328/4094)	66.18% (734/1109)	72.55% (378/521)

Title	Lines	Statements	Branches	Functions
All packages		81.28% (3328/4094)	66.18% (734/1109)	72.55% (378/521)
Components		84.03% (516/614)	69.36% (120/173)	77.23% (95/123)
Mock app		71.89% (371/516)	53.23% (74/139)	68.14% (77/113)
Services		79.29% (1038/1309)	64.88% (255/393)	75.71% (106/140)
UNTP test suite		85.74% (1083/1263)	81.03% (141/174)	67.21% (41/61)
VC test suite		100% (20/20)	100% (2/2)	100% (4/4)
UNTP Playground		82.01% (333/406)	62.6% (144/230)	70.23% (59/84)