@adobe/spacecat-shared-utils 1.27.0 → 1.28.1

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [@adobe/spacecat-shared-utils-v1.28.1](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-utils-v1.28.0...@adobe/spacecat-shared-utils-v1.28.1) (2025-01-21)
+
+
+### Bug Fixes
+
+* getPrompt and replacePlaceholders not properly exported ([#553](https://github.com/adobe/spacecat-shared/issues/553)) ([236839c](https://github.com/adobe/spacecat-shared/commit/236839ca9785f77576889e768cb1707c49bb1fb4))
+
+# [@adobe/spacecat-shared-utils-v1.28.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-utils-v1.27.0...@adobe/spacecat-shared-utils-v1.28.0) (2025-01-21)
+
+
+### Features
+
+* introduce get prompt from static files ([#552](https://github.com/adobe/spacecat-shared/issues/552)) ([0ae7392](https://github.com/adobe/spacecat-shared/commit/0ae739243722812c6b895fe5d843424d23b7f29c))
+
 # [@adobe/spacecat-shared-utils-v1.27.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-utils-v1.26.6...@adobe/spacecat-shared-utils-v1.27.0) (2025-01-21)
 
 

package/package.json

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

package/src/helpers.js

@@ -12,6 +12,7 @@
 
 import { Parser } from '@json2csv/plainjs';
 import { GetSecretValueCommand, SecretsManagerClient } from '@aws-sdk/client-secrets-manager';
+import { promises as fs } from 'fs';
 import { isString } from './functions.js';
 
 /**
@@ -110,3 +111,23 @@ export function replacePlaceholders(content, 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.
+ *
+ * @param {Object} placeholders - A JSON object containing values to replace in the prompt content.
+ * @param {String} filename - The filename of the prompt file.
+ * @param {Object} log - The logger
+ * @returns {Promise<string|null>} - A promise that resolves to a string with the prompt content,
+ * or null if an error occurs.
+ */
+export async function getPrompt(placeholders, filename, log = console) {
+  try {
+    const promptContent = await fs.readFile(`./static/prompts/${filename}.prompt`, { encoding: 'utf8' });
+    return replacePlaceholders(promptContent, placeholders);
+  } catch (error) {
+    log.error('Error reading prompt file:', error.message);
+    return null;
+  }
+}

package/src/index.d.ts

@@ -152,6 +152,19 @@ declare function generateCSVFile(data: object[]): Buffer;
  */
 declare function replacePlaceholders(content: string, placeholders: object): string;
 
+/**
+ * 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.
+ *
+ * @param {Object} placeholders - A JSON object containing values to replace in the prompt content.
+ * @param {String} filename - The filename of the prompt file.
+ * @param {Object} log - The logger
+ * @returns {Promise<string|null>} - A promise that resolves to a string with the prompt content,
+ * or null if an error occurs.
+ */
+declare function getPrompt(placeholders: object, filename: string, log: object):
+  Promise<string|null>;
+
 /**
  * Retrieves stored metrics from S3.
  * @param config - Configuration object

package/src/index.js

@@ -36,6 +36,8 @@ export {
   resolveCustomerSecretsName,
   getRUMDomainKey,
   generateCSVFile,
+  replacePlaceholders,
+  getPrompt,
 } from './helpers.js';
 
 export { sqsWrapper } from './sqs.js';