@ttoss/cloudformation 0.12.13 → 0.13.0

package/README.md

@@ -62,6 +62,42 @@ const template = createApiTemplate({
 });
 ```
 
+When a producing stack exports a value and a consuming stack imports it with
+`Fn::ImportValue`, CloudFormation protects that dependency by blocking deletion
+of the producer export until imports are removed.
+
+Producer stack output example:
+
+```typescript
+const outputs = {
+  LambdaPostgresReadQueryFunctionArn: {
+    Value: { 'Fn::GetAtt': ['LambdaPostgresReadQueryFunction', 'Arn'] },
+    Export: {
+      Name: {
+        'Fn::Sub': '${AWS::StackName}-LambdaPostgresReadQueryFunctionArn',
+      },
+    },
+  },
+};
+```
+
+Consumer stack usage with parameterized export name:
+
+```typescript
+import { importValueFromParameter } from '@ttoss/cloudformation';
+
+const resources = {
+  InvokePermission: {
+    Type: 'AWS::Lambda::Permission',
+    Properties: {
+      FunctionName: importValueFromParameter('ReadQueryFunctionArnExportName'),
+      Action: 'lambda:InvokeFunction',
+      Principal: 'apigateway.amazonaws.com',
+    },
+  },
+};
+```
+
 ## Reading Templates
 
 ### `findAndReadCloudFormationTemplate`

package/dist/esm/index.js

@@ -5,9 +5,19 @@ var __name = (target, value) => __defProp(target, "name", {
   configurable: true
 });
 
+// src/CloudFormationTemplate.ts
+var importValueFromParameter = /* @__PURE__ */__name(parameterName => {
+  return {
+    "Fn::ImportValue": {
+      "Fn::Sub": `\${${parameterName}}`
+    }
+  };
+}, "importValueFromParameter");
+
 // src/findAndReadCloudFormationTemplate.ts
 import * as fs2 from "fs";
 import * as path2 from "path";
+import { readConfigFile } from "@ttoss/read-config-file";
 
 // src/readCloudFormationYamlTemplate.ts
 import * as fs from "fs";
@@ -167,7 +177,6 @@ var readCloudFormationYamlTemplate = /* @__PURE__ */__name(({
 }, "readCloudFormationYamlTemplate");
 
 // src/findAndReadCloudFormationTemplate.ts
-import { readConfigFile } from "@ttoss/read-config-file";
 var defaultTemplatePaths = ["ts", "js", "yaml", "yml", "json"].map(extension => {
   return `./src/cloudformation.${extension}`;
 });
@@ -196,13 +205,4 @@ var findAndReadCloudFormationTemplate = /* @__PURE__ */__name(async ({
     options
   });
 }, "findAndReadCloudFormationTemplate");
-
-// src/CloudFormationTemplate.ts
-var importValueFromParameter = /* @__PURE__ */__name(parameterName => {
-  return {
-    "Fn::ImportValue": {
-      "Fn::Sub": `\${${parameterName}}`
-    }
-  };
-}, "importValueFromParameter");
 export { findAndReadCloudFormationTemplate, importValueFromParameter };

package/dist/index.js

@@ -47,9 +47,19 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/CloudFormationTemplate.ts
+var importValueFromParameter = /* @__PURE__ */__name(parameterName => {
+  return {
+    "Fn::ImportValue": {
+      "Fn::Sub": `\${${parameterName}}`
+    }
+  };
+}, "importValueFromParameter");
+
 // src/findAndReadCloudFormationTemplate.ts
 var fs2 = __toESM(require("fs"), 1);
 var path2 = __toESM(require("path"), 1);
+var import_read_config_file = require("@ttoss/read-config-file");
 
 // src/readCloudFormationYamlTemplate.ts
 var fs = __toESM(require("fs"), 1);
@@ -209,7 +219,6 @@ var readCloudFormationYamlTemplate = /* @__PURE__ */__name(({
 }, "readCloudFormationYamlTemplate");
 
 // src/findAndReadCloudFormationTemplate.ts
-var import_read_config_file = require("@ttoss/read-config-file");
 var defaultTemplatePaths = ["ts", "js", "yaml", "yml", "json"].map(extension => {
   return `./src/cloudformation.${extension}`;
 });
@@ -238,15 +247,6 @@ var findAndReadCloudFormationTemplate = /* @__PURE__ */__name(async ({
     options
   });
 }, "findAndReadCloudFormationTemplate");
-
-// src/CloudFormationTemplate.ts
-var importValueFromParameter = /* @__PURE__ */__name(parameterName => {
-  return {
-    "Fn::ImportValue": {
-      "Fn::Sub": `\${${parameterName}}`
-    }
-  };
-}, "importValueFromParameter");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   findAndReadCloudFormationTemplate,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttoss/cloudformation",
-  "version": "0.12.13",
+  "version": "0.13.0",
   "description": "CloudFormation utils.",
   "keywords": [],
   "repository": {
@@ -33,8 +33,8 @@
     "@types/node": "^24.12.0",
     "jest": "^30.3.0",
     "tsup": "^8.5.1",
-    "@ttoss/config": "^1.37.11",
-    "@ttoss/test-utils": "^4.2.11"
+    "@ttoss/test-utils": "^4.2.11",
+    "@ttoss/config": "^1.37.11"
   },
   "publishConfig": {
     "access": "public",