@adobe/spacecat-shared-utils 1.30.3 → 1.31.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [@adobe/spacecat-shared-utils-v1.31.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-utils-v1.30.4...@adobe/spacecat-shared-utils-v1.31.0) (2025-02-12)
+
+
+### Features
+
+* util for reading .query static files, modeled after getPrompt ([#591](https://github.com/adobe/spacecat-shared/issues/591)) ([af3700d](https://github.com/adobe/spacecat-shared/commit/af3700d4a3d1953a312138f0ca46547eaa31eaac)), closes [#579](https://github.com/adobe/spacecat-shared/issues/579) [#579](https://github.com/adobe/spacecat-shared/issues/579)
+
+# [@adobe/spacecat-shared-utils-v1.30.4](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-utils-v1.30.3...@adobe/spacecat-shared-utils-v1.30.4) (2025-02-12)
+
+
+### Bug Fixes
+
+* log level adjustments ([#597](https://github.com/adobe/spacecat-shared/issues/597)) ([22cc302](https://github.com/adobe/spacecat-shared/commit/22cc302bd1d9d52f6f172748ef8be66dceff599b))
+
 # [@adobe/spacecat-shared-utils-v1.30.3](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-utils-v1.30.2...@adobe/spacecat-shared-utils-v1.30.3) (2025-02-11)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spacecat-shared-utils",
-  "version": "1.30.3",
+  "version": "1.31.0",
   "description": "Shared modules of the Spacecat Services - utils",
   "type": "module",
   "engines": {

package/src/helpers.js

@@ -87,6 +87,19 @@ export function replacePlaceholders(content, placeholders) {
   });
 }
 
+/**
+ * Internal function to support reading static file
+ * and replace placeholder strings with values.
+ *
+ * @param {Object} placeholders - A JSON object containing values to replace in the prompt content.
+ * @param {String} filename - The path of the prompt file.
+ * @returns {Promise<string|null>} - A promise that resolves to a string with the prompt content.
+ */
+async function getStaticContent(placeholders, filename) {
+  const fileContent = await fs.readFile(filename, { encoding: 'utf8' });
+  return replacePlaceholders(fileContent, placeholders);
+}
+
 /**
  * Reads the content of a prompt file asynchronously and replaces any placeholders
  * with the corresponding values. Logs the error and returns null in case of an error.
@@ -99,10 +112,28 @@ export function replacePlaceholders(content, placeholders) {
  */
 export async function getPrompt(placeholders, filename, log = console) {
   try {
-    const promptContent = await fs.readFile(`./static/prompts/${filename}.prompt`, { encoding: 'utf8' });
-    return replacePlaceholders(promptContent, placeholders);
+    return await getStaticContent(placeholders, `./static/prompts/${filename}.prompt`);
   } catch (error) {
     log.error('Error reading prompt file:', error.message);
     return null;
   }
 }
+
+/**
+ * Reads the content of a query file asynchronously and replaces any placeholders
+ * with the corresponding values. Logs the error and returns null in case of an error.
+ *
+ * @param {Object} placeholders - A JSON object containing values to replace in the query content.
+ * @param {String} filename - The filename of the query file.
+ * @param {Object} log - The logger
+ * @returns {Promise<string|null>} - A promise that resolves to a string with the query content,
+ * or null if an error occurs.
+ */
+export async function getQuery(placeholders, filename, log = console) {
+  try {
+    return await getStaticContent(placeholders, `./static/queries/${filename}.query`);
+  } catch (error) {
+    log.error('Error reading query file:', error.message);
+    return null;
+  }
+}

package/src/index.d.ts

@@ -166,6 +166,19 @@ declare function replacePlaceholders(content: string, placeholders: object): str
 declare function getPrompt(placeholders: object, filename: string, log: object):
   Promise<string | null>;
 
+/**
+ * Reads the content of a query file asynchronously and replaces any placeholders
+ * with the corresponding values. Logs the error and returns null in case of an error.
+ *
+ * @param {Object} placeholders - A JSON object containing values to replace in the query content.
+ * @param {String} filename - The filename of the query file.
+ * @param {Object} log - The logger
+ * @returns {Promise<string|null>} - A promise that resolves to a string with the query content,
+ * or null if an error occurs.
+ */
+declare function getQuery(placeholders: object, filename: string, log: object):
+  Promise<string | null>;
+
 /**
  * Retrieves the high-form-view-low-form-conversion metrics from the provided array of form vitals.
  * @param {Object[]} formVitals - An array of form vitals.
@@ -181,7 +194,7 @@ declare function getHighFormViewsLowConversionMetrics(formVitals: object[], inte
  * @returns {Object[]} - An array of high-page-view-low-form-view metrics.
  */
 declare function getHighPageViewsLowFormViewsMetrics(formVitals: object[], interval: number):
-    object[];
+  object[];
 
 /**
  * Retrieves the high-page-view-low-form-ctr metrics from the provided array of form vitals.
@@ -189,7 +202,7 @@ declare function getHighPageViewsLowFormViewsMetrics(formVitals: object[], inter
  * @returns {Object[]} - An array of high-page-view-low-form-ctr metrics.
  */
 declare function getHighPageViewsLowFormCtrMetrics(formVitals: object[], interval: number):
-    object[];
+  object[];
 
 /**
  * Retrieves stored metrics from S3.

package/src/index.js

@@ -37,6 +37,7 @@ export {
   generateCSVFile,
   replacePlaceholders,
   getPrompt,
+  getQuery,
 } from './helpers.js';
 
 export { sqsWrapper } from './sqs.js';

package/src/sqs.js

@@ -117,7 +117,7 @@ export function sqsEventAdapter(fn) {
 
     try {
       message = JSON.parse(record.body);
-      log.info(`Received message with id: ${record.messageId}`);
+      log.debug(`Received message with id: ${record.messageId}`);
     } catch (e) {
       log.warn('Function was not invoked properly, message body is not a valid JSON', e);
       return badRequest('Event does not contain a valid message body');