@adobe/spacecat-shared-data-access 2.38.1 → 2.39.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [@adobe/spacecat-shared-data-access-v2.39.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v2.38.1...@adobe/spacecat-shared-data-access-v2.39.0) (2025-07-22)
+
+
+### Features
+
+* add llmo specific configuration in site config ([#853](https://github.com/adobe/spacecat-shared/issues/853)) ([476b8e8](https://github.com/adobe/spacecat-shared/commit/476b8e84009602a4c9d7ef8d42b9efcae3beae9e))
+
 # [@adobe/spacecat-shared-data-access-v2.38.1](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v2.38.0...@adobe/spacecat-shared-data-access-v2.38.1) (2025-07-22)
 
 

package/package.json

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

package/src/models/site/config.js

@@ -37,6 +37,20 @@ export const IMPORT_SOURCES = {
   RUM: 'rum',
 };
 
+// LLMO question schema for both Human and AI questions
+const QUESTION_SCHEMA = Joi.object({
+  key: Joi.string().required(),
+  question: Joi.string().required(),
+  source: Joi.string().optional(),
+  country: Joi.string().optional(),
+  product: Joi.string().optional(),
+  volume: Joi.string().optional(),
+  keyword: Joi.string().optional(),
+  url: Joi.string().uri().optional(),
+  tags: Joi.array().items(Joi.string()).optional(),
+  importTime: Joi.string().isoDate().optional(),
+});
+
 const IMPORT_BASE_KEYS = {
   destinations: Joi.array().items(Joi.string().valid(IMPORT_DESTINATIONS.DEFAULT)).required(),
   sources: Joi.array().items(Joi.string().valid(...Object.values(IMPORT_SOURCES))).required(),
@@ -201,6 +215,14 @@ export const configSchema = Joi.object({
     headers: Joi.object().pattern(Joi.string(), Joi.string()),
     overrideBaseURL: Joi.string().uri().optional(),
   }).optional(),
+  llmo: Joi.object({
+    dataFolder: Joi.string().required(),
+    brand: Joi.string().required(),
+    questions: Joi.object({
+      Human: Joi.array().items(QUESTION_SCHEMA).optional(),
+      AI: Joi.array().items(QUESTION_SCHEMA).optional(),
+    }).optional(),
+  }).optional(),
   cdnLogsConfig: Joi.object({
     bucketName: Joi.string().required(),
     filters: Joi.array().items(
@@ -291,6 +313,11 @@ export const Config = (data = {}) => {
   self.getFetchConfig = () => state?.fetchConfig;
   self.getBrandConfig = () => state?.brandConfig;
   self.getCdnLogsConfig = () => state?.cdnLogsConfig;
+  self.getLlmoConfig = () => state?.llmo;
+  self.getLlmoDataFolder = () => state?.llmo?.dataFolder;
+  self.getLlmoBrand = () => state?.llmo?.brand;
+  self.getLlmoHumanQuestions = () => state?.llmo?.questions?.Human;
+  self.getLlmoAIQuestions = () => state?.llmo?.questions?.AI;
 
   self.updateSlackConfig = (channel, workspace, invitedUserCount) => {
     state.slack = {
@@ -300,6 +327,64 @@ export const Config = (data = {}) => {
     };
   };
 
+  self.updateLlmoConfig = (dataFolder, brand, questions) => {
+    state.llmo = {
+      dataFolder,
+      brand,
+      ...(questions !== undefined ? { questions } : {}),
+    };
+  };
+
+  self.updateLlmoDataFolder = (dataFolder) => {
+    state.llmo = state.llmo || {};
+    state.llmo.dataFolder = dataFolder;
+  };
+
+  self.updateLlmoBrand = (brand) => {
+    state.llmo = state.llmo || {};
+    state.llmo.brand = brand;
+  };
+
+  self.addLlmoHumanQuestions = (questions) => {
+    state.llmo = state.llmo || {};
+    state.llmo.questions = state.llmo.questions || {};
+    state.llmo.questions.Human = state.llmo.questions.Human || [];
+    state.llmo.questions.Human.push(...questions);
+  };
+
+  self.addLlmoAIQuestions = (questions) => {
+    state.llmo = state.llmo || {};
+    state.llmo.questions = state.llmo.questions || {};
+    state.llmo.questions.AI = state.llmo.questions.AI || [];
+    state.llmo.questions.AI.push(...questions);
+  };
+
+  self.removeLlmoQuestion = (key) => {
+    state.llmo = state.llmo || {};
+    state.llmo.questions = state.llmo.questions || {};
+    state.llmo.questions.Human = state.llmo.questions.Human || [];
+    state.llmo.questions.Human = state.llmo.questions.Human.filter(
+      (question) => question.key !== key,
+    );
+    state.llmo.questions.AI = state.llmo.questions.AI || [];
+    state.llmo.questions.AI = state.llmo.questions.AI.filter(
+      (question) => question.key !== key,
+    );
+  };
+
+  self.updateLlmoQuestion = (key, questionUpdate) => {
+    state.llmo = state.llmo || {};
+    state.llmo.questions = state.llmo.questions || {};
+    state.llmo.questions.Human = state.llmo.questions.Human || [];
+    state.llmo.questions.Human = state.llmo.questions.Human.map(
+      (question) => (question.key === key ? { ...question, ...questionUpdate, key } : question),
+    );
+    state.llmo.questions.AI = state.llmo.questions.AI || [];
+    state.llmo.questions.AI = state.llmo.questions.AI.map(
+      (question) => (question.key === key ? { ...question, ...questionUpdate, key } : question),
+    );
+  };
+
   self.updateImports = (imports) => {
     state.imports = imports;
   };
@@ -409,4 +494,5 @@ Config.toDynamoItem = (config) => ({
   fetchConfig: config.getFetchConfig(),
   brandConfig: config.getBrandConfig(),
   cdnLogsConfig: config.getCdnLogsConfig(),
+  llmo: config.getLlmoConfig(),
 });

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

@@ -61,6 +61,19 @@ export interface ImportConfig {
   limit?: number;
 }
 
+export interface LlmoQuestion {
+  key: string;
+  question: string;
+  source?: string;
+  country?: string;
+  product?: string;
+  volume?: string;
+  importTime?: string;
+  keyword?: string;
+  url?: string;
+  tags?: string[];
+}
+
 export interface SiteConfig {
   state: {
     slack?: {
@@ -97,6 +110,14 @@ export interface SiteConfig {
       headers?: Record<string, string>;
       overrideBaseURL?: string;
     };
+    llmo?: {
+      dataFolder: string;
+      brand: string;
+      questions?: {
+        Human?: Array<LlmoQuestion>;
+        AI?: Array<LlmoQuestion>;
+      };
+    };
   };
   getSlackConfig(): { workspace?: string; channel?: string; invitedUserCount?: number };
   getImports(): ImportConfig[];
@@ -116,6 +137,25 @@ export interface SiteConfig {
   getLatestMetrics(type: string):
     { pageViewsChange: number; ctrChange: number; projectedTrafficValue: number } | undefined;
   getFetchConfig(): { headers?: Record<string, string>, overrideBaseURL?: string } | undefined;
+  getLlmoConfig(): {
+    dataFolder: string;
+    brand: string;
+    questions?: { Human?: Array<LlmoQuestion>; AI?: Array<LlmoQuestion> };
+  } | undefined;
+  updateLlmoConfig(dataFolder: string, brand: string, questions?: {
+    Human?: Array<LlmoQuestion>;
+    AI?: Array<LlmoQuestion>;
+  }): void;
+  updateLlmoDataFolder(dataFolder: string): void;
+  updateLlmoBrand(brand: string): void;
+  getLlmoDataFolder(): string | undefined;
+  getLlmoBrand(): string | undefined;
+  getLlmoHumanQuestions(): LlmoQuestion[] | undefined;
+  getLlmoAIQuestions(): LlmoQuestion[] | undefined;
+  addLlmoHumanQuestions(questions: LlmoQuestion[]): void;
+  addLlmoAIQuestions(questions: LlmoQuestion[]): void;
+  removeLlmoQuestion(key: string): void;
+  updateLlmoQuestion(key: string, questionUpdate: Partial<LlmoQuestion>): void;
 }
 
 export interface Site extends BaseModel {