carlin 1.48.0 → 1.48.2

package/dist/index.js

@@ -813,7 +813,34 @@ var saveEnvironmentOutput = /* @__PURE__ */ __name(async ({ outputs, stackName }
   const latestFilePath = path.join(dotCarlinFolderPath, LATEST_DEPLOY_OUTPUTS_FILENAME);
   await fs3.promises.writeFile(latestFilePath, JSON.stringify(envFile, null, 2));
 }, "saveEnvironmentOutput");
-var printStackOutputsAfterDeploy = /* @__PURE__ */ __name(async ({ stackName }) => {
+var exportEnvVars = /* @__PURE__ */ __name(async ({ outputs, envExport }) => {
+  const githubEnvFile = process.env.GITHUB_ENV;
+  for (const [cfOutputKey, envVarName] of Object.entries(envExport)) {
+    const output = outputs.find(({ OutputKey }) => {
+      return OutputKey === cfOutputKey;
+    });
+    if (!output?.OutputValue) {
+      log5.warn(logPrefix3, `envExport: CloudFormation output "${cfOutputKey}" not found or has no value. Skipping export of "${envVarName}".`);
+      continue;
+    }
+    const value = output.OutputValue;
+    if (githubEnvFile) {
+      if (value.includes("\n")) {
+        log5.warn(logPrefix3, `envExport: value for "${cfOutputKey}" contains newlines and cannot be exported to GITHUB_ENV safely. Skipping.`);
+        continue;
+      }
+      await fs3.promises.appendFile(githubEnvFile, `${envVarName}=${value}
+`);
+      log5.info(logPrefix3, `envExport: wrote ${envVarName} to GITHUB_ENV`);
+    } else {
+      const escapedValue = value.replace(/'/g, `'\\''`);
+      process.stdout.write(`export ${envVarName}='${escapedValue}'
+`);
+      log5.info(logPrefix3, `envExport: printed export ${envVarName} to stdout`);
+    }
+  }
+}, "exportEnvVars");
+var printStackOutputsAfterDeploy = /* @__PURE__ */ __name(async ({ stackName, envExport }) => {
   const { EnableTerminationProtection, StackName, Outputs = [] } = await describeStack({
     stackName
   });
@@ -834,6 +861,12 @@ var printStackOutputsAfterDeploy = /* @__PURE__ */ __name(async ({ stackName })
       ""
     ].join("\n"));
   }
+  if (envExport && Object.keys(envExport).length > 0) {
+    await exportEnvVars({
+      outputs: Outputs,
+      envExport
+    });
+  }
 }, "printStackOutputsAfterDeploy");
 var deleteStack = /* @__PURE__ */ __name(async ({ stackName }) => {
   log5.info(logPrefix3, `Deleting stack ${stackName}...`);
@@ -906,7 +939,7 @@ var enableTerminationProtection = /* @__PURE__ */ __name(async ({ stackName }) =
     throw error;
   }
 }, "enableTerminationProtection");
-var deploy = /* @__PURE__ */ __name(async ({ terminationProtection = false, ...paramsAndTemplate }) => {
+var deploy = /* @__PURE__ */ __name(async ({ terminationProtection = false, envExport, ...paramsAndTemplate }) => {
   const { params, template } = await addDefaults(paramsAndTemplate);
   const stackName = params.StackName;
   if (!stackName) {
@@ -945,7 +978,8 @@ var deploy = /* @__PURE__ */ __name(async ({ terminationProtection = false, ...p
     });
   }
   await printStackOutputsAfterDeploy({
-    stackName
+    stackName,
+    envExport
   });
   return describeStack({
     stackName
@@ -3458,7 +3492,7 @@ var getCloudformationTemplateOptions = /* @__PURE__ */ __name(({ cliOptions, sta
 }, "getCloudformationTemplateOptions");
 var deployCloudFormation = /* @__PURE__ */ __name(async (cliOptions) => {
   try {
-    const { lambdaDockerfile, lambdaEntryPoints, lambdaEntryPointsBaseDir, lambdaImage, lambdaExternal, lambdaFormat, lambdaOutdir, parameters, template, templatePath } = cliOptions;
+    const { lambdaDockerfile, lambdaEntryPoints, lambdaEntryPointsBaseDir, lambdaImage, lambdaExternal, lambdaFormat, lambdaOutdir, parameters, template, templatePath, envExport } = cliOptions;
     const { stackName } = await handleDeployInitialization({
       logPrefix: logPrefix12
     });
@@ -3619,7 +3653,8 @@ var deployCloudFormation = /* @__PURE__ */ __name(async (cliOptions) => {
     await deployCloudFormationDeployLambdaCode();
     const output = await deploy({
       params,
-      template: cloudFormationTemplate
+      template: cloudFormationTemplate,
+      envExport
     });
     return output;
   } catch (error) {
@@ -5028,6 +5063,50 @@ var options6 = {
     describe: "Set the stack name.",
     type: "string"
   },
+  /**
+  * Mapping of CloudFormation output keys to environment variable names.
+  * After a successful deployment, carlin reads the stack outputs and exports
+  * the mapped variables to the CI/CD runner environment:
+  *
+  * - **GitHub Actions**: appends `KEY=VALUE` lines to `$GITHUB_ENV`.
+  * - **Generic shell**: prints `export KEY=VALUE` lines to stdout.
+  *
+  * Configure in your `carlin.ts`:
+  *
+  * ```ts
+  * export default {
+  *   envExport: {
+  *     AppSyncApiGraphQLUrl: 'VITE_APPSYNC_GRAPHQL_ENDPOINT',
+  *     AppSyncApiArn: 'APPSYNC_API_ARN',
+  *   },
+  * };
+  * ```
+  *
+  * Can also be combined with per-environment config:
+  *
+  * ```ts
+  * export default {
+  *   environments: {
+  *     Staging: {
+  *       envExport: {
+  *         AppSyncApiGraphQLUrl: 'VITE_APPSYNC_GRAPHQL_ENDPOINT',
+  *       },
+  *     },
+  *   },
+  * };
+  * ```
+  */
+  "env-export": {
+    describe: "Mapping of CloudFormation output keys to environment variable names to export after deployment.",
+    coerce: /* @__PURE__ */ __name((arg) => {
+      if (typeof arg === "object" && arg !== null && !Array.isArray(arg) && Object.values(arg).every((v) => {
+        return typeof v === "string";
+      })) {
+        return arg;
+      }
+      return void 0;
+    }, "coerce")
+  },
   "template-path": {
     alias: "t",
     describe: "Path to the CloudFormation template.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carlin",
-  "version": "1.48.0",
+  "version": "1.48.2",
   "description": "",
   "license": "MIT",
   "author": "Pedro Arantes <arantespp@gmail.com> (https://twitter.com/arantespp)",
@@ -47,9 +47,9 @@
     "uglify-js": "^3.19.3",
     "vercel": "^39.1.1",
     "yargs": "^17.7.2",
-    "@ttoss/cloudformation": "^0.12.7",
-    "@ttoss/read-config-file": "^2.2.5",
-    "@ttoss/config": "^1.37.5"
+    "@ttoss/cloudformation": "^0.12.9",
+    "@ttoss/config": "^1.37.7",
+    "@ttoss/read-config-file": "^2.2.7"
   },
   "devDependencies": {
     "@types/adm-zip": "^0.5.6",
@@ -69,7 +69,7 @@
     "jest": "^30.3.0",
     "tsup": "^8.5.1",
     "typescript": "~6.0.2",
-    "@ttoss/test-utils": "^4.2.5"
+    "@ttoss/test-utils": "^4.2.7"
   },
   "keywords": [],
   "publishConfig": {