feat(data-access): add allByEnrollmentProductCode to SiteCollection

[jindaliiita]

Summary

• Adds allSiteIdsByProductCode(productCode) to SiteEnrollmentCollection — performs a single PostgREST JOIN query (site_enrollments ⨝ entitlements) to return all site IDs enrolled in a given product code
• Adds allByEnrollmentProductCode(productCode, options) to SiteCollection — uses the above to scope site fetching to a specific product (e.g. LLMO), then batch-fetches full Site objects with caller-controlled field projection via options.attributes
• Adds unit tests with 100% coverage for both new methods (9 new test cases across 2 files)

Motivation

Required by the optimize-at-edge-enabled-marking import worker job, which previously fetched all sites via Site.all(). Scoping to LLMO-enrolled sites reduces unnecessary data transfer and in-memory filtering as the DB scales.

Test plan

• SiteEnrollmentCollection — allSiteIdsByProductCode: falsy input, happy path with data, empty data, null data, DB error
• SiteCollection — allByEnrollmentProductCode: falsy input, empty site IDs (early return), default options, custom options forwarded to batchGetByKeys
• All 40 tests in both collection test files pass

🤖 Generated with Claude Code

[nit23uec]

Free trials dont have entitlement info.

[jindaliiita]

Free trials dont have entitlement info.

I am able to see it for site ID 1f09e6f5-ad35-4772-bdbb-c1b19a364c4f and org ID d6bfa68d-c137-4203-acd5-1ac7d2d49d84, but not sure if I am missing something.

[ { "id": "884118b6-9b97-479b-9fd2-5a3d4105c0ff", "organizationId": "d6bfa68d-c137-4203-acd5-1ac7d2d49d84", "productCode": "LLMO", "tier": "FREE_TRIAL", "quotas": { "llmo_trial_prompts": 200, "llmo_trial_prompts_consumed": 0 }, "createdAt": "2026-02-24T18:36:33.536Z", "updatedAt": "2026-02-28T18:43:22.748Z", "updatedBy": "system" } ]

[github-actions]

This PR will trigger a minor release when merged.

[jindaliiita]

Free trials dont have entitlement info.

Yes, they have, confirmed it with @ravverma. @ravverma, please correct me if I am wrong here.

[solaris007]

🎉 This PR is included in version @adobe/spacecat-shared-data-access-v3.30.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀