@adobe/spacecat-shared-data-access 3.28.0 → 3.30.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [@adobe/spacecat-shared-data-access-v3.30.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v3.29.0...@adobe/spacecat-shared-data-access-v3.30.0) (2026-03-25)
+
+### Features
+
+* **data-access:** add allByEnrollmentProductCode to SiteCollection ([#1455](https://github.com/adobe/spacecat-shared/issues/1455)) ([0225791](https://github.com/adobe/spacecat-shared/commit/02257915bbf5aa2e15e1320bbcdfa27b236c44b8))
+
+## [@adobe/spacecat-shared-data-access-v3.29.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v3.28.0...@adobe/spacecat-shared-data-access-v3.29.0) (2026-03-23)
+
+### Features
+
+* **page-citability:** add UPDATED_BY_PRERENDER and UPDATED_BY_PAGE_CITABILITY constants ([#1460](https://github.com/adobe/spacecat-shared/issues/1460)) ([dcdf2b0](https://github.com/adobe/spacecat-shared/commit/dcdf2b0af9b9426631e9363949027a267ce7d015))
+
 ## [@adobe/spacecat-shared-data-access-v3.28.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v3.27.1...@adobe/spacecat-shared-data-access-v3.28.0) (2026-03-23)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spacecat-shared-data-access",
-  "version": "3.28.0",
+  "version": "3.30.0",
   "description": "Shared modules of the Spacecat Services - Data Access",
   "type": "module",
   "engines": {

package/src/models/page-citability/page-citability.model.js

@@ -23,6 +23,10 @@ class PageCitability extends BaseModel {
 
   static DEFAULT_UPDATED_BY = 'spacecat';
 
+  static UPDATED_BY_PRERENDER = 'prerender';
+
+  static UPDATED_BY_PAGE_CITABILITY = 'page-citability';
+
   // add any custom methods or overrides here
 }
 

package/src/models/site/config.js

@@ -848,5 +848,5 @@ Config.toDynamoItem = (config) => ({
   llmo: config.getLlmoConfig(),
   tokowakaConfig: config.getTokowakaConfig(),
   edgeOptimizeConfig: config.getEdgeOptimizeConfig(),
-  commerceLlmoConfig: config.getCommerceLlmoConfig(),
+  commerceLlmoConfig: config.getCommerceLlmoConfig?.(),
 });

package/src/models/site/site.collection.js

@@ -145,6 +145,35 @@ class SiteCollection extends BaseCollection {
     return this.allByProjectId(projectId);
   }
 
+  /**
+   * Returns all sites enrolled in a given product (e.g. 'LLMO', 'ASO').
+   * Uses entityRegistry to chain through EntitlementCollection and SiteEnrollmentCollection,
+   * then batch-fetches full Site objects.
+   *
+   * @param {string} productCode - Product code to filter by (e.g. 'LLMO').
+   * @returns {Promise<Site[]>}
+   */
+  async allByEnrollmentProductCode(productCode, options = {}) {
+    if (!hasText(productCode)) {
+      throw new DataAccessError('productCode is required', this);
+    }
+
+    const siteEnrollmentCollection = this.entityRegistry.getCollection('SiteEnrollmentCollection');
+
+    // Query 1: get all site IDs enrolled in the given product (single JOIN query)
+    const siteIds = await siteEnrollmentCollection.allSiteIdsByProductCode(productCode);
+    if (siteIds.length === 0) {
+      return [];
+    }
+
+    // Query 2: batch-fetch Site objects (caller controls which fields to fetch)
+    const { data: sites } = await this.batchGetByKeys(
+      siteIds.map((siteId) => ({ siteId })),
+      options,
+    );
+    return sites;
+  }
+
   async allByOrganizationIdAndProjectName(organizationId, projectName) {
     if (!hasText(organizationId)) {
       throw new DataAccessError('organizationId is required', this);

package/src/models/site-enrollment/site-enrollment.collection.js

@@ -11,6 +11,7 @@
  */
 
 import BaseCollection from '../base/base.collection.js';
+import DataAccessError from '../../errors/data-access.error.js';
 
 /**
  * SiteEnrollmentCollection - A class representing a collection of SiteEnrollment entities.
@@ -22,6 +23,30 @@ import BaseCollection from '../base/base.collection.js';
 class SiteEnrollmentCollection extends BaseCollection {
   static COLLECTION_NAME = 'SiteEnrollmentCollection';
 
+  /**
+   * Returns all site IDs enrolled in a given product code in a single JOIN query.
+   *
+   * @param {string} productCode - Product code to filter by (e.g. 'LLMO').
+   * @returns {Promise<string[]>} Array of siteId strings.
+   */
+  async allSiteIdsByProductCode(productCode) {
+    if (!productCode) {
+      throw new DataAccessError('productCode is required', { entityName: 'SiteEnrollment', tableName: 'site_enrollments' });
+    }
+
+    const { data, error } = await this.postgrestService
+      .from(this.tableName)
+      .select('site_id, entitlements!inner(product_code)')
+      .eq('entitlements.product_code', productCode);
+
+    if (error) {
+      this.log.error(`[SiteEnrollmentCollection] Failed to query site_enrollments by productCode - ${error.message}`, error);
+      throw new DataAccessError('Failed to query site_enrollments by productCode', { entityName: 'SiteEnrollment', tableName: 'site_enrollments' }, error);
+    }
+
+    return (data || []).map((row) => row.site_id);
+  }
+
   async create(item, options = {}) {
     if (item?.siteId && item?.entitlementId) {
       const existing = await this.findByIndexKeys({