dromanis.finora.functions.common 1.0.1 → 1.0.3

package/README.md

@@ -3,7 +3,8 @@
 A set of common utilities used across different AWS Lambda functions in the Dromanis Finora ecosystem.
 
 ## Features
-- **userAuthenticator**: Easily add JWT authentication to your AWS Lambda functions.
+- **userAuthenticator**: Easily add JWT authentication to your AWS Lambda functions with decoded token access.
+- **corsHandler**: Handle CORS headers and OPTIONS requests for API Gateway responses.
 - TypeScript-first, fully typed for safety and autocompletion.
 - Includes automated tests and Husky hooks for code quality.
 
@@ -15,7 +16,9 @@ npm install dromanis.finora.functions.common
 
 ## Usage
 
-````typescript
+### JWT Authentication
+
+```typescript
 import { userAuthenticator } from 'dromanis.finora.functions.common';
 import { APIGatewayProxyEvent } from 'aws-lambda';
 
@@ -26,13 +29,43 @@ export const handler = async (event: APIGatewayProxyEvent) => {
   if (result.statusCode !== 200) {
     return result;
   }
+  
+  // Access the decoded token payload
+  const userData = result.decodedToken;
+  console.log('User:', userData.user, 'Role:', userData.role);
+  
   // Proceed with your logic
   return {
+    statusCode: 200,
+    body: JSON.stringify({ message: 'Success!', user: userData.user })
+  };
+};
+```
+
+### CORS Handling
+
+```typescript
+import { corsHandler } from 'dromanis.finora.functions.common';
+import { APIGatewayProxyEvent, APIGatewayProxyResult } from 'aws-lambda';
+
+const cors = new corsHandler();
+
+export const handler = async (event: APIGatewayProxyEvent): Promise<APIGatewayProxyResult> => {
+  // Handle OPTIONS requests
+  if (event.httpMethod === 'OPTIONS') {
+    return cors.handleOptionsMethod();
+  }
+
+  // Your main logic
+  const response = {
     statusCode: 200,
     body: JSON.stringify({ message: 'Success!' })
   };
+
+  // Add CORS headers to your response
+  return cors.handleWithCors(response);
 };
-````
+```
 
 ## Testing
 

package/dist/corsHandler.d.ts

@@ -0,0 +1,6 @@
+import { APIGatewayProxyResult } from 'aws-lambda';
+export declare class corsHandler {
+    handleWithCors(response: APIGatewayProxyResult): APIGatewayProxyResult;
+    handleOptionsMethod(): APIGatewayProxyResult;
+}
+//# sourceMappingURL=corsHandler.d.ts.map

package/dist/corsHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corsHandler.d.ts","sourceRoot":"","sources":["../src/corsHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,WAAW;IACtB,cAAc,CAAC,QAAQ,EAAE,qBAAqB,GAAG,qBAAqB;IAYtE,mBAAmB,IAAI,qBAAqB;CAM7C"}

package/dist/corsHandler.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.corsHandler = void 0;
+class corsHandler {
+    handleWithCors(response) {
+        return {
+            ...response,
+            headers: {
+                ...(response.headers || {}),
+                'Access-Control-Allow-Origin': '*',
+                'Access-Control-Allow-Headers': '*',
+                'Access-Control-Allow-Methods': 'GET,POST,PUT,DELETE,OPTIONS',
+            },
+        };
+    }
+    handleOptionsMethod() {
+        return this.handleWithCors({
+            statusCode: 200,
+            body: ''
+        });
+    }
+}
+exports.corsHandler = corsHandler;
+//# sourceMappingURL=corsHandler.js.map

package/dist/corsHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"corsHandler.js","sourceRoot":"","sources":["../src/corsHandler.ts"],"names":[],"mappings":";;;AAEA,MAAa,WAAW;IACtB,cAAc,CAAC,QAA+B;QAC5C,OAAO;YACL,GAAG,QAAQ;YACX,OAAO,EAAE;gBACP,GAAG,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;gBAC3B,6BAA6B,EAAE,GAAG;gBAClC,8BAA8B,EAAE,GAAG;gBACnC,8BAA8B,EAAE,6BAA6B;aAC9D;SACF,CAAC;IACJ,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,cAAc,CAAC;YACzB,UAAU,EAAE,GAAG;YACf,IAAI,EAAE,EAAE;SACT,CAAC,CAAC;IACL,CAAC;CACF;AAnBD,kCAmBC"}

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export * from './userAuthenticator';
+export * from './corsHandler';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./userAuthenticator"), exports);
+__exportStar(require("./corsHandler"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,gDAA8B"}

package/dist/userAuthenticator.d.ts

@@ -1,9 +1,15 @@
 import { APIGatewayProxyEvent } from 'aws-lambda';
+import jwt from 'jsonwebtoken';
 export declare class userAuthenticator {
     constructor();
     authenticate(event: APIGatewayProxyEvent): {
         statusCode: number;
         body: string;
+        decodedToken?: never;
+    } | {
+        statusCode: number;
+        decodedToken: string | jwt.JwtPayload;
+        body: string;
     };
 }
 //# sourceMappingURL=userAuthenticator.d.ts.map

package/dist/userAuthenticator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"userAuthenticator.d.ts","sourceRoot":"","sources":["../src/userAuthenticator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,qBAAa,iBAAiB;;IAK1B,YAAY,CAAC,KAAK,EAAE,oBAAoB;;;;CA6B3C"}
+{"version":3,"file":"userAuthenticator.d.ts","sourceRoot":"","sources":["../src/userAuthenticator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,GAAG,MAAM,cAAc,CAAC;AAE/B,qBAAa,iBAAiB;;IAK1B,YAAY,CAAC,KAAK,EAAE,oBAAoB;;;;;;;;;CA8B3C"}

package/dist/userAuthenticator.js

@@ -26,9 +26,10 @@ class userAuthenticator {
             };
         }
         try {
-            jsonwebtoken_1.default.verify(token, secret);
+            let decodedToke = jsonwebtoken_1.default.verify(token, secret);
             return {
                 statusCode: 200,
+                decodedToken: decodedToke,
                 body: JSON.stringify({ message: 'Authenticated' })
             };
         }

package/dist/userAuthenticator.js.map

@@ -1 +1 @@
-{"version":3,"file":"userAuthenticator.js","sourceRoot":"","sources":["../src/userAuthenticator.ts"],"names":[],"mappings":";;;;;;AACA,gEAA+B;AAE/B,MAAa,iBAAiB;IAC1B;QACI,iCAAiC;IACrC,CAAC;IAED,YAAY,CAAC,KAA2B;QACpC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,eAAe,CAAC,CAAC;QACxF,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACnD,OAAO;gBACH,UAAU,EAAE,GAAG;gBACf,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;aAC7E,CAAC;QACN,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO;gBACH,UAAU,EAAE,GAAG;gBACf,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC;aAC/D,CAAC;QACN,CAAC;QACD,IAAI,CAAC;YACD,sBAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC1B,OAAO;gBACH,UAAU,EAAE,GAAG;gBACf,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;aACrD,CAAC;QACN,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO;gBACH,UAAU,EAAE,GAAG;gBACf,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC;aAC9D,CAAC;QACN,CAAC;IACL,CAAC;CACJ;AAlCD,8CAkCC"}
+{"version":3,"file":"userAuthenticator.js","sourceRoot":"","sources":["../src/userAuthenticator.ts"],"names":[],"mappings":";;;;;;AACA,gEAA+B;AAE/B,MAAa,iBAAiB;IAC1B;QACI,iCAAiC;IACrC,CAAC;IAED,YAAY,CAAC,KAA2B;QACpC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,eAAe,CAAC,CAAC;QACxF,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACnD,OAAO;gBACH,UAAU,EAAE,GAAG;gBACf,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;aAC7E,CAAC;QACN,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO;gBACH,UAAU,EAAE,GAAG;gBACf,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC;aAC/D,CAAC;QACN,CAAC;QACD,IAAI,CAAC;YACD,IAAI,WAAW,GAAG,sBAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC5C,OAAO;gBACH,UAAU,EAAE,GAAG;gBACf,YAAY,EAAE,WAAW;gBACzB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;aACrD,CAAC;QACN,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO;gBACH,UAAU,EAAE,GAAG;gBACf,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC;aAC9D,CAAC;QACN,CAAC;IACL,CAAC;CACJ;AAnCD,8CAmCC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dromanis.finora.functions.common",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",