[aaqilniz]

This PR improves OpenAPI schema generation in @loopback/repository-json-schema and @loopback/openapi-v3 by adding x-foreign-keys and x-relation-type metadata to the x-relationships object.

Previously, parsing relationship metadata from OpenAPI specs was limited because standard outputs lacked information about specific relationship types (e.g., distinguishing between a standard hasMany and a hasManyThrough) and associated foreign keys.

Changes

1. Vendor Extension Type (SpecificationExtension):

   • Introduced a local template-literal index signature ([key: x-${string}]: unknown) in @loopback/repository-json-schema/types.ts.

2. Schema Building Refactor (build-schema.ts):

   • Populates x-foreign-keys and x-relation-type alongside existing relationship metadata during model schema generation.
   • Consolidated relationship iteration and cleanup logic to properly aggregate multiple relation entries without overwriting sibling definitions.

3. OpenAPI Conversion Support (json-to-schema.ts):

   • Updated JSON-to-schema property conversion handlers to properly map and retain x-relationships vendor extensions.

4. Testing:

   • Added and updated integration and unit tests covering hasMany, belongsTo, hasOne, and referencesMany relationship extensions.

Checklist

• DCO (Developer Certificate of Origin) signed in all commits
• npm test passes on your machine
• New tests added or existing tests modified to cover all changes
• Code conforms with the style guide
• API Documentation in code was updated
• Documentation in /docs/site was updated
• Affected artifact templates in packages/cli were updated
• Affected example projects in examples/* were updated

👉 Check out how to submit a PR 👈

[coveralls]

Pull Request Test Coverage Report for Build 8657413748

Details

• 56 of 72 (77.78%) changed or added relevant lines in 2 files are covered.
• 1 unchanged line in 1 file lost coverage.
• Overall coverage increased (+0.06%) to 55.432%

---

Changes Missing Coverage	Covered Lines	Changed/Added Lines	%
packages/repository-json-schema/src/build-schema.ts	49	65	75.38%

Files with Coverage Reduction	New Missed Lines	%
packages/openapi-v3/src/json-to-schema.ts	1	79.65%

Totals
Change from base Build 8646446166:	0.06%
Covered Lines:	9616
Relevant Lines:	12527

---

💛 - Coveralls