@ttoss/lambda-postgres-query 1.0.1 → 1.1.0

package/README.md

@@ -289,6 +289,31 @@ Each function in `createLambdaPostgresQueryTemplate` can use different `database
 
 Grant each consumer `lambda:InvokeFunction` only for the ARN output it needs, such as `LambdaPostgresReadQueryFunctionArn` for read-only consumers.
 
+ARN outputs are exported with this CloudFormation export name pattern:
+
+- `${AWS::StackName}-${outputArnName}`
+
+The practical reason to export these names is also deletion safety: when another stack imports an ARN export, CloudFormation blocks deleting the producer stack resource until that import is removed.
+
+For example, `LambdaPostgresReadQueryFunctionArn` is exported as `${AWS::StackName}-LambdaPostgresReadQueryFunctionArn`.
+
+In a consumer stack, define a parameter with that export name and import it using `importValueFromParameter`:
+
+```typescript
+import { importValueFromParameter } from '@ttoss/cloudformation';
+
+const resources = {
+  InvokePermission: {
+    Type: 'AWS::Lambda::Permission',
+    Properties: {
+      FunctionName: importValueFromParameter('ReadQueryFunctionArnExportName'),
+      Action: 'lambda:InvokeFunction',
+      Principal: 'apigateway.amazonaws.com',
+    },
+  },
+};
+```
+
 ## API Reference
 
 ### `createLambdaPostgresQueryTemplate(options?)`
@@ -303,8 +328,10 @@ Creates a CloudFormation template for one or more PostgreSQL query Lambdas.
   - `handler` (string, optional): Handler function. Default: `'handler.handler'`
   - `databaseParameters` (object, optional): CloudFormation parameter names used to inject database settings into that Lambda
   - `outputArnName` (string, optional): Output key for the function ARN. Default: `${name}Arn`
+    - The ARN output is exported with `Export.Name = ${AWS::StackName}-${outputArnName}`
 - `memorySize` (number, optional): Lambda memory size in MB. Default: `128`
 - `timeout` (number, optional): Lambda timeout in seconds. Default: `30`
+- `deletionProtection` (boolean, optional): Adds `DeletionPolicy: Retain` and `UpdateReplacePolicy: Retain` to each Lambda resource so stack updates/deletes do not remove functions. Default: `false`
 
 #### Returns
 

package/dist/cloudformation/index.d.cts

@@ -26,9 +26,10 @@ type CreateLambdaPostgresQueryTemplateOptions = {
     functions?: LambdaDefinition[];
     memorySize?: number;
     timeout?: number;
+    deletionProtection?: boolean;
 };
 declare const DATABASE_PARAMETERS_DEFAULT: DatabaseParameters;
-declare const createLambdaPostgresQueryTemplate: ({ functions, memorySize, timeout, }?: CreateLambdaPostgresQueryTemplateOptions) => CloudFormationTemplate;
+declare const createLambdaPostgresQueryTemplate: ({ functions, memorySize, timeout, deletionProtection, }?: CreateLambdaPostgresQueryTemplateOptions) => CloudFormationTemplate;
 
 declare const handler: Handler<QueryParams>;
 

package/dist/cloudformation/index.d.ts

@@ -26,9 +26,10 @@ type CreateLambdaPostgresQueryTemplateOptions = {
     functions?: LambdaDefinition[];
     memorySize?: number;
     timeout?: number;
+    deletionProtection?: boolean;
 };
 declare const DATABASE_PARAMETERS_DEFAULT: DatabaseParameters;
-declare const createLambdaPostgresQueryTemplate: ({ functions, memorySize, timeout, }?: CreateLambdaPostgresQueryTemplateOptions) => CloudFormationTemplate;
+declare const createLambdaPostgresQueryTemplate: ({ functions, memorySize, timeout, deletionProtection, }?: CreateLambdaPostgresQueryTemplateOptions) => CloudFormationTemplate;
 
 declare const handler: Handler<QueryParams>;
 

package/dist/cloudformation/index.js

@@ -147,11 +147,17 @@ var createLambdaResource = /* @__PURE__ */__name(({
   handler: handler2,
   databaseParameters,
   memorySize,
-  timeout
+  timeout,
+  deletionProtection
 }) => {
+  const resourcePolicies = deletionProtection ? {
+    DeletionPolicy: "Retain",
+    UpdateReplacePolicy: "Retain"
+  } : {};
   return {
     [functionName]: {
       Type: "AWS::Lambda::Function",
+      ...resourcePolicies,
       Properties: {
         Code: {
           S3Bucket: {
@@ -223,7 +229,8 @@ var createLambdaLogResource = /* @__PURE__ */__name(({
 var createResources = /* @__PURE__ */__name(({
   functions,
   memorySize,
-  timeout
+  timeout,
+  deletionProtection
 }) => {
   return functions.reduce((allResources, lambdaFunction) => {
     const {
@@ -238,7 +245,8 @@ var createResources = /* @__PURE__ */__name(({
         handler: handler2,
         databaseParameters,
         memorySize,
-        timeout
+        timeout,
+        deletionProtection
       }),
       ...createLambdaLogResource({
         logicalId: name
@@ -266,6 +274,11 @@ var createOutputs = /* @__PURE__ */__name(({
         Description: `Lambda function to query PostgreSQL (${name}) ARN.`,
         Value: {
           "Fn::GetAtt": [name, "Arn"]
+        },
+        Export: {
+          Name: {
+            "Fn::Sub": `\${AWS::StackName}-${outputArnName}`
+          }
         }
       }
     };
@@ -321,7 +334,8 @@ var createExecutionRoleResource = /* @__PURE__ */__name(() => {
 var createLambdaPostgresQueryTemplate = /* @__PURE__ */__name(({
   functions,
   memorySize = MEMORY_SIZE_DEFAULT,
-  timeout = TIMEOUT_DEFAULT
+  timeout = TIMEOUT_DEFAULT,
+  deletionProtection = false
 } = {}) => {
   const templateFunctions = normalizeFunctions({
     functions
@@ -332,7 +346,8 @@ var createLambdaPostgresQueryTemplate = /* @__PURE__ */__name(({
   const templateResources = createResources({
     functions: templateFunctions,
     memorySize,
-    timeout
+    timeout,
+    deletionProtection
   });
   const templateOutputs = createOutputs({
     functions: templateFunctions

package/dist/esm/cloudformation/index.js

@@ -107,11 +107,17 @@ var createLambdaResource = /* @__PURE__ */__name(({
   handler: handler2,
   databaseParameters,
   memorySize,
-  timeout
+  timeout,
+  deletionProtection
 }) => {
+  const resourcePolicies = deletionProtection ? {
+    DeletionPolicy: "Retain",
+    UpdateReplacePolicy: "Retain"
+  } : {};
   return {
     [functionName]: {
       Type: "AWS::Lambda::Function",
+      ...resourcePolicies,
       Properties: {
         Code: {
           S3Bucket: {
@@ -183,7 +189,8 @@ var createLambdaLogResource = /* @__PURE__ */__name(({
 var createResources = /* @__PURE__ */__name(({
   functions,
   memorySize,
-  timeout
+  timeout,
+  deletionProtection
 }) => {
   return functions.reduce((allResources, lambdaFunction) => {
     const {
@@ -198,7 +205,8 @@ var createResources = /* @__PURE__ */__name(({
         handler: handler2,
         databaseParameters,
         memorySize,
-        timeout
+        timeout,
+        deletionProtection
       }),
       ...createLambdaLogResource({
         logicalId: name
@@ -226,6 +234,11 @@ var createOutputs = /* @__PURE__ */__name(({
         Description: `Lambda function to query PostgreSQL (${name}) ARN.`,
         Value: {
           "Fn::GetAtt": [name, "Arn"]
+        },
+        Export: {
+          Name: {
+            "Fn::Sub": `\${AWS::StackName}-${outputArnName}`
+          }
         }
       }
     };
@@ -281,7 +294,8 @@ var createExecutionRoleResource = /* @__PURE__ */__name(() => {
 var createLambdaPostgresQueryTemplate = /* @__PURE__ */__name(({
   functions,
   memorySize = MEMORY_SIZE_DEFAULT,
-  timeout = TIMEOUT_DEFAULT
+  timeout = TIMEOUT_DEFAULT,
+  deletionProtection = false
 } = {}) => {
   const templateFunctions = normalizeFunctions({
     functions
@@ -292,7 +306,8 @@ var createLambdaPostgresQueryTemplate = /* @__PURE__ */__name(({
   const templateResources = createResources({
     functions: templateFunctions,
     memorySize,
-    timeout
+    timeout,
+    deletionProtection
   });
   const templateOutputs = createOutputs({
     functions: templateFunctions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttoss/lambda-postgres-query",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Create a Lambda function that queries a PostgreSQL database.",
   "keywords": [
     "aws",
@@ -37,7 +37,7 @@
     "@aws-sdk/client-lambda": "^3.1025.0",
     "camelcase-keys": "^7.0.2",
     "pg": "^8.20.0",
-    "@ttoss/cloudformation": "^0.12.13"
+    "@ttoss/cloudformation": "^0.13.0"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",