@adobe/spacecat-shared-data-access 2.81.0 → 2.83.0

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+# [@adobe/spacecat-shared-data-access-v2.83.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v2.82.0...@adobe/spacecat-shared-data-access-v2.83.0) (2025-11-14)
+
+
+### Features
+
+* Add top-level brandProfile to Site Config with versioning and hash; tests and fixtures ([#1125](https://github.com/adobe/spacecat-shared/issues/1125)) ([6dcd3f8](https://github.com/adobe/spacecat-shared/commit/6dcd3f848d0dcc7303a9778ee86fc334166e2b68))
+* added a new type reporting for fix entity ([#1121](https://github.com/adobe/spacecat-shared/issues/1121)) ([47f44b8](https://github.com/adobe/spacecat-shared/commit/47f44b81f073bdf1801746fb9e348a661f3a3fc5))
+
+# [@adobe/spacecat-shared-data-access-v2.82.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v2.81.0...@adobe/spacecat-shared-data-access-v2.82.0) (2025-11-13)
+
+
+### Features
+
+* add ahref-paid-import ([#1120](https://github.com/adobe/spacecat-shared/issues/1120)) ([3818671](https://github.com/adobe/spacecat-shared/commit/381867174c60d157c2b5cd9fe68dc6f6a30fb71b))
+
 # [@adobe/spacecat-shared-data-access-v2.81.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v2.80.2...@adobe/spacecat-shared-data-access-v2.81.0) (2025-11-11)
 
 

package/package.json

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

package/src/models/fix-entity/fix-entity.model.js

@@ -29,9 +29,12 @@ class FixEntity extends BaseModel {
     ROLLED_BACK: 'ROLLED_BACK', // the fix has been rolled_back
   };
 
+  // reporting is a new origin which is used
+  // to denote the fix entities created by the reporting team
   static ORIGINS = {
     SPACECAT: 'spacecat',
     ASO: 'aso',
+    REPORTING: 'reporting',
   };
 
   async getSuggestions() {

package/src/models/site/config.js

@@ -10,7 +10,10 @@
  * governing permissions and limitations under the License.
  */
 
+import { isNonEmptyObject } from '@adobe/spacecat-shared-utils';
+import crypto from 'crypto';
 import Joi from 'joi';
+
 import { getLogger } from '../../util/logger-registry.js';
 
 export const IMPORT_TYPES = {
@@ -22,6 +25,7 @@ export const IMPORT_TYPES = {
   ORGANIC_KEYWORDS_QUESTIONS: 'organic-keywords-questions',
   ORGANIC_TRAFFIC: 'organic-traffic',
   TOP_PAGES: 'top-pages',
+  AHREF_PAID_PAGES: 'ahref-paid-pages',
   ALL_TRAFFIC: 'all-traffic',
   CWV_DAILY: 'cwv-daily',
   CWV_WEEKLY: 'cwv-weekly',
@@ -134,6 +138,13 @@ export const IMPORT_TYPE_SCHEMAS = {
     limit: Joi.number().integer().min(1).max(2000)
       .optional(),
   }),
+  [IMPORT_TYPES.AHREF_PAID_PAGES]: Joi.object({
+    type: Joi.string().valid(IMPORT_TYPES.AHREF_PAID_PAGES).required(),
+    ...IMPORT_BASE_KEYS,
+    geo: Joi.string().optional(),
+    limit: Joi.number().integer().min(1).max(2000)
+      .optional(),
+  }),
   [IMPORT_TYPES.CWV_DAILY]: Joi.object({
     type: Joi.string().valid(IMPORT_TYPES.CWV_DAILY).required(),
     ...IMPORT_BASE_KEYS,
@@ -210,6 +221,12 @@ export const DEFAULT_IMPORT_CONFIGS = {
     enabled: true,
     geo: 'global',
   },
+  'ahref-paid-pages': {
+    type: 'ahref-paid-pages',
+    destinations: ['default'],
+    sources: ['ahrefs'],
+    enabled: true,
+  },
   'cwv-daily': {
     type: 'cwv-daily',
     destinations: ['default'],
@@ -255,6 +272,21 @@ export const configSchema = Joi.object({
     brandId: Joi.string().required(),
     userId: Joi.string().required(),
   }).optional(),
+  brandProfile: Joi.object({
+    // functional metadata
+    version: Joi.number().integer().min(0),
+    updatedAt: Joi.string().isoDate(),
+    contentHash: Joi.string(),
+    // generic top-level content containers (non-strict)
+    discovery: Joi.any(),
+    clustering: Joi.any(),
+    competitive_context: Joi.any(),
+    main_profile: Joi.any(),
+    sub_brands: Joi.any(),
+    confidence_score: Joi.any(),
+    pages_considered: Joi.any(),
+    diversity_assessment: Joi.any(),
+  }).unknown(true).optional(),
   fetchConfig: Joi.object({
     headers: Joi.object().pattern(Joi.string(), Joi.string()),
     overrideBaseURL: Joi.string().uri().optional(),
@@ -400,6 +432,7 @@ export const Config = (data = {}) => {
   self.getLatestMetrics = (type) => state?.handlers?.[type]?.latestMetrics;
   self.getFetchConfig = () => state?.fetchConfig;
   self.getBrandConfig = () => state?.brandConfig;
+  self.getBrandProfile = () => state?.brandProfile;
   self.getCdnLogsConfig = () => state?.cdnLogsConfig;
   self.getLlmoConfig = () => state?.llmo;
   self.getLlmoDataFolder = () => state?.llmo?.dataFolder;
@@ -616,6 +649,48 @@ export const Config = (data = {}) => {
     state.brandConfig = brandConfig;
   };
 
+  /**
+   * Updates the top-level brandProfile with versioning and content hashing.
+   * Version is incremented only if the meaningful content changes.
+   * @param {object} newProfile
+   */
+  self.updateBrandProfile = (newProfile = {}) => {
+    const prior = state.brandProfile || {};
+    // compute hash over all content except functional fields
+    const stripFunctional = (p) => {
+      if (!isNonEmptyObject(p)) return {};
+      const {
+        /* eslint-disable no-unused-vars */
+        version, updatedAt, contentHash, ...rest
+      } = p;
+      return rest;
+    };
+    const meaningful = stripFunctional(newProfile);
+    const contentHash = crypto.createHash('sha256')
+      .update(JSON.stringify(meaningful))
+      .digest('hex');
+
+    if (prior?.contentHash === contentHash) {
+      state.brandProfile = {
+        ...prior,
+        ...newProfile,
+        contentHash: prior.contentHash,
+        version: prior.version,
+        updatedAt: prior.updatedAt,
+      };
+      return;
+    }
+
+    const version = (prior?.version || 0) + 1;
+    state.brandProfile = {
+      ...prior,
+      ...meaningful,
+      version,
+      contentHash,
+      updatedAt: new Date().toISOString(),
+    };
+  };
+
   self.enableImport = (type, config = {}) => {
     if (!IMPORT_TYPE_SCHEMAS[type]) {
       throw new Error(`Unknown import type: ${type}`);
@@ -677,6 +752,7 @@ Config.toDynamoItem = (config) => ({
   imports: config.getImports(),
   fetchConfig: config.getFetchConfig(),
   brandConfig: config.getBrandConfig(),
+  brandProfile: config.getBrandProfile(),
   cdnLogsConfig: config.getCdnLogsConfig(),
   llmo: config.getLlmoConfig(),
   tokowakaConfig: config.getTokowakaConfig(),

package/src/models/site/index.d.ts

@@ -47,6 +47,7 @@ export type IMPORT_TYPES = {
   readonly ORGANIC_KEYWORDS: 'organic-keywords';
   readonly ORGANIC_TRAFFIC: 'organic-traffic';
   readonly TOP_PAGES: 'top-pages';
+  readonly AHREF_PAID_PAGES: 'ahref-paid-pages';
   readonly TOP_FORMS: 'top-forms';
 };
 
@@ -59,7 +60,7 @@ export type IMPORT_SOURCES = {
   readonly GSC: 'google';
 };
 
-export type ImportType = 'organic-keywords' | 'organic-traffic' | 'top-pages' | 'top-forms';
+export type ImportType = 'organic-keywords' | 'organic-traffic' | 'top-pages' | 'top-forms' | 'ahref-paid-pages' ;
 export type ImportDestination = 'default';
 export type ImportSource = 'ahrefs' | 'google';