@63klabs/cache-data 1.2.9 → 1.3.0

package/CHANGELOG.md

@@ -8,7 +8,21 @@ Report all vulnerabilities under the [Security menu](https://github.com/63Klabs/
 
 > Note: This project is still in beta. Even though changes are tested and breaking changes are avoided, things may break.
 
-## 1.2.9 (2025-07-15)
+## 1.3.0 (2025-07-16)
+
+### Enhancements
+
+- Removed AWS SDK V2 support which closes [issue-213](https://github.com/63Klabs/cache-data/issues/213). AWS SDK V2 was for versions of Node 16 and under, and since they are no longer supported Lambda runtimes, support has been removed from cache-data.
+
+### Fixes
+
+- Addressed deprecation warnings (handled by Amazon Q Developer):
+  - Eliminated Warning:
+    - querystring@0.2.0 - From aws-sdk v2 (removed aws-sdk v2)
+  - Remaining Warning (unavoidable):
+    - lodash.get@4.4.2 - From sinon dependency (external package)
+
+## 1.2.10 (2025-07-15)
 
 ### Enhancements
 

package/README.md

@@ -69,7 +69,7 @@ See [Change Log](CHANGELOG.md) for version history and changes.
 
 ## Issues, Features, and Enhancements
 
-Visit the [Issues section of the @63Klabs Cache-Data GitHub repository](https://github.com/63klabs/cache-data) for information on reported issues, upcoming fixes and enhancements, and to submit requests.
+Visit the [Issues section of the @63Klabs Cache-Data GitHub repository](https://github.com/63Klabs/cache-data/issues) for information on reported issues, upcoming fixes and enhancements, and to submit requests.
 
 ## License
 
@@ -81,8 +81,8 @@ This project is licensed under the MIT License - see the LICENSE.txt file for de
 
 - Software, DevOps, and Developer Experience Engineer
 - [AWS Certified Developer - Associate](https://www.credly.com/users/chad-kluck/badges)
-- [Website](https://chadkluck.me/)
-- [GitHub](https://github.com/chadkluck)
-- [GitHub (63Klabs)](https://github.com/63klabs)
+- [Website: chadkluck.me](https://chadkluck.me/)
+- [GitHub: chadkluck](https://github.com/chadkluck)
+- [GitHub: 63Klabs](https://github.com/63klabs)
 - [Mastodon: @chadkluck@universeodon.com](https://universeodon.com/@chadkluck)
 - [LinkedIn](https://www.linkedin.com/in/chadkluck/)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@63klabs/cache-data",
-  "version": "1.2.9",
+  "version": "1.3.0",
   "description": "Cache data from an API endpoint or application process using AWS S3 and DynamoDb",
   "author": "Chad Leigh Kluck (https://chadkluck.me)",
   "license": "MIT",
@@ -13,7 +13,7 @@
     "test": "test"
   },
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=18.0.0"
   },
   "dependencies": {
     "aws-xray-sdk-core": "^3.6.0",
@@ -25,10 +25,9 @@
     "@aws-sdk/client-s3": "3.x",
     "@aws-sdk/client-ssm": "3.x",
     "@aws-sdk/lib-dynamodb": "3.x",
-    "aws-sdk": "2.x",
     "chai": "^5.2.0",
-    "chai-http": "^5.1.1",
-    "mocha": "^11.1.0",
+    "chai-http": "^5.1.2",
+    "mocha": "^11.7.1",
     "sinon": "^21.0.0"
   },
   "scripts": {

package/src/lib/tools/AWS.classes.js

@@ -1,20 +1,32 @@
 const isTrue = (value) => {
-	return (value !== null && typeof value !== 'undefined' && (value === true || value.toLowerCase() === "true" || value === 1 || value === "1"));
+	return (value !== null && typeof value !== 'undefined' && 
+		(value === true || value === 1 || value === "1" || 
+		(typeof value === 'string' && value.toLowerCase() === "true")));
 };
 
-const AWSXRay = (isTrue(process.env?.CacheData_AWSXRayOn) || isTrue(process.env?.CACHE_DATA_AWS_X_RAY_ON) ) ? require("aws-xray-sdk-core") : null;
-
-if (AWSXRay !== null) {
-	// Configure capture options
-	const captureOptions = {
-		captureRequestInit: true,  // Capture request init
-		captureResponse: true,     // Capture response
-		generateUniqueId: true     // Generate unique IDs for each request
-	};
-
-	AWSXRay.captureHTTPsGlobal(require('http'), captureOptions);
-	AWSXRay.captureHTTPsGlobal(require("https"), captureOptions);	
-}
+const USE_XRAY = isTrue(process.env?.CacheData_AWSXRayOn) || isTrue(process.env?.CACHE_DATA_AWS_X_RAY_ON);
+
+let AWSXRay = null;
+let xrayInitialized = false;
+
+const initializeXRay = () => {
+	if (!xrayInitialized && USE_XRAY) {
+		try {
+			AWSXRay = require("aws-xray-sdk-core");
+			const captureOptions = {
+				captureRequestInit: true,
+				captureResponse: true,
+				generateUniqueId: true
+			};
+			AWSXRay.captureHTTPsGlobal(require('http'), captureOptions);
+			AWSXRay.captureHTTPsGlobal(require("https"), captureOptions);
+		} catch (error) {
+			AWSXRay = null;
+		}
+		xrayInitialized = true;
+	}
+	return AWSXRay;
+};
 
 /**
  * AWS Helper Functions - Functions to perform common get and put operations for DynamoDB, S3, and SSM parameter store.
@@ -76,7 +88,9 @@ class AWS {
 	static #nodeVer = [];
 	static #aws_region = null;
 
-	static #XRayOn = (AWSXRay !== null);
+	static get #XRayOn() {
+		return initializeXRay() !== null;
+	}
 
 	constructor() {}
 
@@ -131,38 +145,15 @@ class AWS {
 			REGION: this.REGION,
 			SDK_V2: this.SDK_V2,
 			SDK_V3: this.SDK_V3,
-			AWSXRayOn: this.#XRayOn
+			AWSXRayOn: USE_XRAY
 		});
 	}
 
 	static #SDK = (
 		function(){
-			if (AWS.SDK_V2) {
-				const { DynamoDB, S3, SSM } = (this.#XRayOn) ? AWSXRay.captureAWS(require("aws-sdk")) : require("aws-sdk");
-				return {
-					dynamo: {
-						client: (new DynamoDB.DocumentClient( {region: AWS.REGION} )), 
-						put: (client, params) => client.put(params).promise(),
-						get: (client, params) => client.get(params).promise(),
-						scan: (client, params) => client.scan(params).promise(),
-						delete: (client, params) => client.delete(params).promise(),
-						update: (client, params) => client.update(params).promise(),
-						sdk: { DynamoDB }
-					},
-					s3: {
-						client: (new S3()),
-						put: (client, params) => client.putObject(params).promise(),
-						get: (client, params) => client.getObject(params).promise(),
-						sdk: { S3 }
-					},
-					ssm: {
-						client: (new SSM( {region: AWS.REGION} )),
-						getByName: (client, params) => client.getParameters(params).promise(),
-						getByPath: (client, params) => client.getParametersByPath(params).promise(),
-						sdk: { SSM }
-					}
-				}
-			} else {
+
+			if (AWS.SDK_V3) {
+			
 				const { DynamoDBClient} = require("@aws-sdk/client-dynamodb");
 				const { DynamoDBDocumentClient, GetCommand, PutCommand, ScanCommand, DeleteCommand, UpdateCommand } = require("@aws-sdk/lib-dynamodb");
 				const { S3, GetObjectCommand, PutObjectCommand } = require("@aws-sdk/client-s3");
@@ -210,7 +201,10 @@ class AWS {
 							GetParametersCommand
 						}
 					}
-				}			
+				}	
+			}
+			else {
+				throw new Error("AWS SDK v2 is no longer supported. Please upgrade to Node.js 18 or higher to use AWS SDK v3.");
 			}
 		}
 	)();