@adobe/spacecat-shared-data-access 2.0.4 → 2.0.5

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [@adobe/spacecat-shared-data-access-v2.0.5](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v2.0.4...@adobe/spacecat-shared-data-access-v2.0.5) (2025-01-25)
+
+
+### Bug Fixes
+
+* **deps:** update external fixes ([#561](https://github.com/adobe/spacecat-shared/issues/561)) ([e922c1d](https://github.com/adobe/spacecat-shared/commit/e922c1df3b9a7bfcf6a5699d65bcb02dc130393a))
+
 # [@adobe/spacecat-shared-data-access-v2.0.4](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v2.0.3...@adobe/spacecat-shared-data-access-v2.0.4) (2025-01-18)
 
 

package/README.md

@@ -102,7 +102,7 @@ The module provides the following DAOs:
 ## Integrating Data Access in AWS Lambda Functions
 
 Our `spacecat-shared-data-access` module includes a wrapper that can be easily integrated into AWS Lambda functions using `@adobe/helix-shared-wrap`.
-This integration allows your Lambda functions to access and manipulate data seamlessly.
+This integration allows your Lambda functions to access and manipulate data.
 
 ### Steps for Integration
 
@@ -111,10 +111,19 @@ This integration allows your Lambda functions to access and manipulate data seam
    Along with other wrappers and utilities, import the `dataAccessWrapper`.
 
    ```javascript
-   import dataAccessWrapper from '@adobe/spacecat-shared-data-access/wrapper';
+   import dataAccessWrapper from '@adobe/spacecat-shared-data-access';
    ```
 
-2. **Modify Your Lambda Wrapper Script**
+2. **Provide Required Environment Variables**
+
+   The `dataAccessWrapper` requires the `DYNAMO_TABLE_NAME_DATA` environment variable to be set via AWS
+   secret assigned to your Lambda function.
+
+   ```javascript
+   const { DYNAMO_TABLE_NAME_DATA } = context.env;
+   ```
+
+3. **Modify Your Lambda Wrapper Script**
 
    Include `dataAccessWrapper` in the chain of wrappers when defining your Lambda handler.
 
@@ -127,7 +136,7 @@ This integration allows your Lambda functions to access and manipulate data seam
      .with(helixStatus);
    ```
 
-3. **Access Data in Your Lambda Function**
+4. **Access Data in Your Lambda Function**
 
    Use the `dataAccess` object from the context to interact with your data layer.
 
@@ -136,7 +145,7 @@ This integration allows your Lambda functions to access and manipulate data seam
      const { dataAccess } = context;
      
      // Example: Retrieve all sites
-     const sites = await dataAccess.getSites();
+     const sites = await dataAccess.Site.getSites();
      // ... more logic ...
    }
    ```
@@ -147,7 +156,7 @@ Here's a complete example of a Lambda function utilizing the data access wrapper
 
 ```javascript
 import wrap from '@adobe/helix-shared-wrap';
-import dataAccessWrapper from '@adobe/spacecat-shared-data-access/wrapper';
+import dataAccessWrapper from '@adobe/spacecat-shared-data-access';
 import sqsEventAdapter from './sqsEventAdapter';
 import sqs from './sqs';
 import secrets from '@adobe/helix-shared-secrets';
@@ -156,7 +165,7 @@ import helixStatus from '@adobe/helix-status';
 async function run(message, context) {
   const { dataAccess } = context;
   try {
-    const sites = await dataAccess.getSites();
+    const sites = await dataAccess.Site.getSites();
     // Function logic here
   } catch (error) {
     // Error handling

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spacecat-shared-data-access",
-  "version": "2.0.4",
+  "version": "2.0.5",
   "description": "Shared modules of the Spacecat Services - Data Access",
   "type": "module",
   "engines": {
@@ -35,10 +35,10 @@
   },
   "dependencies": {
     "@adobe/spacecat-shared-utils": "1.26.4",
-    "@aws-sdk/client-dynamodb": "3.731.1",
-    "@aws-sdk/lib-dynamodb": "3.731.1",
+    "@aws-sdk/client-dynamodb": "3.734.0",
+    "@aws-sdk/lib-dynamodb": "3.734.0",
     "@types/joi": "17.2.3",
-    "aws-xray-sdk": "3.10.2",
+    "aws-xray-sdk": "3.10.3",
     "electrodb": "3.0.1",
     "joi": "17.13.3",
     "pluralize": "8.0.0",

package/src/index.js

@@ -16,7 +16,21 @@ export * from './service/index.js';
 
 const TABLE_NAME_DATA = 'spacecat-services-data-dev';
 
+/**
+ * Wrapper for data access layer
+ * @param {function} fn - The function to wrap
+ * @returns {function} - The wrapped function
+ */
 export default function dataAccessWrapper(fn) {
+  /**
+   * Wrapper for data access layer. This wrapper will create a data access layer if it is not
+   * already created. It requires the context to have a log object. It will also use the
+   * DYNAMO_TABLE_NAME_DATA environment variable to create the data access layer.
+   *
+   * @param {object} request - The request object
+   * @param {object} context - The context object
+   * @returns {Promise<object>} - The wrapped function
+   */
   return async (request, context) => {
     if (!context.dataAccess) {
       const { log } = context;

package/src/readme.md

@@ -215,3 +215,19 @@ await user.save();
 ## Consideration for Indexes
 
 Indexes cost money and complexity. Do not add indexes lightly. Determine which query patterns you truly need and only then introduce additional indexes.
+
+## Data Access Service
+
+You can use the data layer by obtaining a service instance through the `createDataAccess` function:
+
+```javascript
+const { createDataAccess } = require('@adobe/spacecat-shared-data-access');
+
+const dataAccess = createDataAccess({
+  tableNameData: 'spacecat-services-data-dev',
+});
+
+// You can now use the dataAccess object to interact with the data layer
+const sites = await dataAccess.Site.getSites();
+```
+

package/src/service/index.js

@@ -50,18 +50,12 @@ const createElectroService = (client, config, log) => {
 };
 
 /**
- * Creates a data access object.
+ * Creates a data access layer for interacting with DynamoDB using ElectroDB.
  *
- * @param {{pkAllSites: string, pkAllLatestAudits: string, indexNameAllLatestAuditScores: string,
- * tableNameAudits: string,tableNameLatestAudits: string, indexNameAllSitesOrganizations: string,
- * tableNameSites: string, tableNameOrganizations: string, tableNameExperiments: string,
- * indexNameAllSites: string,
- * tableNameImportJobs: string, pkAllImportJobs: string, indexNameAllImportJobs: string,
- * tableNameSiteTopPages: string, indexNameAllOrganizations: string,
- * indexNameAllOrganizationsByImsOrgId: string, pkAllOrganizations: string}} config configuration
- * @param {Logger} log log
- * @param client custom dynamo client
- * @returns {object} data access object
+ * @param {{tableNameData: string}} config - Configuration object containing table name
+ * @param {object} log - Logger instance, defaults to console
+ * @param {DynamoDB} [client] - Optional custom DynamoDB client instance
+ * @returns {object} Data access collections for interacting with entities
  */
 export const createDataAccess = (config, log = console, client = undefined) => {
   const rawClient = createRawClient(client);