@stackgenhq/backstage-plugin-stackgen-backend 0.3.6-beta.1

package/dist/actions/core/set_environment_variable_values_action.cjs.js

@@ -0,0 +1,121 @@
+'use strict';
+
+var pluginScaffolderNode = require('@backstage/plugin-scaffolder-node');
+var zod = require('zod');
+var topologyResolve = require('../../exporter/topologyResolve.cjs.js');
+var apiObjects = require('../../utils/api-objects.cjs.js');
+
+const setEnvironmentVariableValuesInputSchema = zod.z.object({
+  teamId: zod.z.string().min(1, "teamId is required"),
+  environmentId: zod.z.string().min(1, "environmentId is required"),
+  topologyId: zod.z.string().optional(),
+  appstackName: zod.z.string().optional(),
+  variableValues: zod.z.array(
+    zod.z.object({
+      name: zod.z.string().min(1),
+      value: zod.z.string()
+    })
+  ).default([])
+}).superRefine((value, ctx) => {
+  if (!value.topologyId?.trim() && !value.appstackName?.trim()) {
+    ctx.addIssue({
+      code: zod.z.ZodIssueCode.custom,
+      message: "topologyId or appstackName is required",
+      path: ["topologyId"]
+    });
+  }
+});
+const setEnvironmentVariableValuesOutputSchema = zod.z.object({
+  updatedCount: zod.z.number(),
+  updatedVariablesText: zod.z.string(),
+  environmentId: zod.z.string(),
+  topologyId: zod.z.string()
+});
+function parseVariableValue(raw) {
+  const trimmed = raw.trim();
+  if (trimmed === "") {
+    return "";
+  }
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    return raw;
+  }
+}
+const setEnvironmentVariableValuesAction = (config, logger) => {
+  return pluginScaffolderNode.createTemplateAction({
+    id: "stackGen:setEnvironmentVariableValues",
+    description: "Sets Terraform variable values on an existing StackGen environment profile",
+    schema: {
+      input: () => setEnvironmentVariableValuesInputSchema,
+      output: () => setEnvironmentVariableValuesOutputSchema
+    },
+    async handler(ctx) {
+      const stackgenApis = apiObjects.getStackgenApiObjects(config);
+      const teamId = ctx.input.teamId.trim();
+      const environmentId = ctx.input.environmentId.trim();
+      const variableValues = ctx.input.variableValues ?? [];
+      let topologyId = ctx.input.topologyId?.trim() || "";
+      if (!topologyId) {
+        topologyId = await topologyResolve.resolveTopologyId({
+          config,
+          teamId,
+          appstackName: ctx.input.appstackName?.trim()});
+      }
+      if (variableValues.length === 0) {
+        ctx.logger.info("No variable values provided; skipping updates");
+        ctx.output("updatedCount", 0);
+        ctx.output("updatedVariablesText", "No variables updated");
+        ctx.output("environmentId", environmentId);
+        ctx.output("topologyId", topologyId);
+        return;
+      }
+      const updated = [];
+      for (const pair of variableValues) {
+        const variableIdentifier = pair.name.trim();
+        const value = parseVariableValue(pair.value);
+        ctx.logger.info(
+          `Setting ${variableIdentifier} on env ${environmentId} (topology=${topologyId})`
+        );
+        try {
+          await stackgenApis.v1TfBlocksApiObj.updateTFVariableEnvironmentProfileValue(
+            {
+              topologyId,
+              orgId: teamId,
+              variableIdentifier,
+              envProfileId: environmentId,
+              tFVariableEnvironmentProfileValue: {
+                envProfileId: environmentId,
+                value
+              }
+            }
+          );
+          updated.push(`${variableIdentifier} = ${pair.value}`);
+        } catch (error) {
+          const parsedError = await apiObjects.readClientError(error);
+          const detail = apiObjects.formatApiFailure(
+            parsedError.status,
+            parsedError.body,
+            parsedError.text,
+            parsedError.requestId
+          );
+          throw new Error(
+            `Failed to set ${variableIdentifier} on environment ${environmentId}: ${detail}`
+          );
+        }
+      }
+      logger.info(
+        `stackGen:setEnvironmentVariableValues updated=${updated.length} env=${environmentId}`
+      );
+      ctx.output("updatedCount", updated.length);
+      ctx.output("updatedVariablesText", updated.join("\n"));
+      ctx.output("environmentId", environmentId);
+      ctx.output("topologyId", topologyId);
+    }
+  });
+};
+
+exports.setEnvironmentVariableValuesAction = setEnvironmentVariableValuesAction;
+exports.setEnvironmentVariableValuesInputSchema = setEnvironmentVariableValuesInputSchema;
+exports.setEnvironmentVariableValuesOutputSchema = setEnvironmentVariableValuesOutputSchema;
+//# sourceMappingURL=set_environment_variable_values_action.cjs.js.map

package/dist/actions/core/set_environment_variable_values_action.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set_environment_variable_values_action.cjs.js","sources":["../../../src/actions/core/set_environment_variable_values_action.ts"],"sourcesContent":["import { createTemplateAction } from \"@backstage/plugin-scaffolder-node\";\nimport { LoggerService } from \"@backstage/backend-plugin-api\";\nimport { Config } from \"@backstage/config\";\nimport { z } from \"zod\";\nimport { resolveTopologyId } from \"../../exporter/topologyResolve\";\nimport {\n  formatApiFailure,\n  getStackgenApiObjects,\n  readClientError,\n} from \"../../utils/api-objects\";\n\nexport const setEnvironmentVariableValuesInputSchema = z\n  .object({\n    teamId: z.string().min(1, \"teamId is required\"),\n    environmentId: z.string().min(1, \"environmentId is required\"),\n    topologyId: z.string().optional(),\n    appstackName: z.string().optional(),\n    variableValues: z\n      .array(\n        z.object({\n          name: z.string().min(1),\n          value: z.string(),\n        }),\n      )\n      .default([]),\n  })\n  .superRefine((value, ctx) => {\n    if (!value.topologyId?.trim() && !value.appstackName?.trim()) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        message: \"topologyId or appstackName is required\",\n        path: [\"topologyId\"],\n      });\n    }\n  });\n\nexport const setEnvironmentVariableValuesOutputSchema = z.object({\n  updatedCount: z.number(),\n  updatedVariablesText: z.string(),\n  environmentId: z.string(),\n  topologyId: z.string(),\n});\n\nfunction parseVariableValue(raw: string): unknown {\n  const trimmed = raw.trim();\n  if (trimmed === \"\") {\n    return \"\";\n  }\n  try {\n    return JSON.parse(trimmed);\n  } catch {\n    return raw;\n  }\n}\n\n/**\n * Applies VariableSelect values onto an existing environment profile\n * (consumption / override), matching appcd-ui TF env value updates.\n */\nexport const setEnvironmentVariableValuesAction = (\n  config: Config,\n  logger: LoggerService,\n) => {\n  return createTemplateAction({\n    id: \"stackGen:setEnvironmentVariableValues\",\n    description:\n      \"Sets Terraform variable values on an existing StackGen environment profile\",\n    schema: {\n      input: () => setEnvironmentVariableValuesInputSchema,\n      output: () => setEnvironmentVariableValuesOutputSchema,\n    },\n    async handler(ctx) {\n      const stackgenApis = getStackgenApiObjects(config);\n      const teamId = ctx.input.teamId.trim();\n      const environmentId = ctx.input.environmentId.trim();\n      const variableValues = ctx.input.variableValues ?? [];\n\n      let topologyId = ctx.input.topologyId?.trim() || \"\";\n      if (!topologyId) {\n        topologyId = await resolveTopologyId({\n          config,\n          teamId,\n          appstackName: ctx.input.appstackName?.trim(),\n          logger,\n        });\n      }\n\n      if (variableValues.length === 0) {\n        ctx.logger.info(\"No variable values provided; skipping updates\");\n        ctx.output(\"updatedCount\", 0);\n        ctx.output(\"updatedVariablesText\", \"No variables updated\");\n        ctx.output(\"environmentId\", environmentId);\n        ctx.output(\"topologyId\", topologyId);\n        return;\n      }\n\n      const updated: string[] = [];\n      for (const pair of variableValues) {\n        const variableIdentifier = pair.name.trim();\n        const value = parseVariableValue(pair.value);\n        ctx.logger.info(\n          `Setting ${variableIdentifier} on env ${environmentId} (topology=${topologyId})`,\n        );\n        try {\n          await stackgenApis.v1TfBlocksApiObj.updateTFVariableEnvironmentProfileValue(\n            {\n              topologyId,\n              orgId: teamId,\n              variableIdentifier,\n              envProfileId: environmentId,\n              tFVariableEnvironmentProfileValue: {\n                envProfileId: environmentId,\n                value,\n              } as never,\n            },\n          );\n          updated.push(`${variableIdentifier} = ${pair.value}`);\n        } catch (error) {\n          const parsedError = await readClientError(error);\n          const detail = formatApiFailure(\n            parsedError.status,\n            parsedError.body,\n            parsedError.text,\n            parsedError.requestId,\n          );\n          throw new Error(\n            `Failed to set ${variableIdentifier} on environment ${environmentId}: ${detail}`,\n          );\n        }\n      }\n\n      logger.info(\n        `stackGen:setEnvironmentVariableValues updated=${updated.length} env=${environmentId}`,\n      );\n      ctx.output(\"updatedCount\", updated.length);\n      ctx.output(\"updatedVariablesText\", updated.join(\"\\n\"));\n      ctx.output(\"environmentId\", environmentId);\n      ctx.output(\"topologyId\", topologyId);\n    },\n  });\n};\n"],"names":["z","createTemplateAction","getStackgenApiObjects","resolveTopologyId","readClientError","formatApiFailure"],"mappings":"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"}

package/dist/actions/core/set_state_backend_action.cjs.js

@@ -0,0 +1,174 @@
+'use strict';
+
+var pluginScaffolderNode = require('@backstage/plugin-scaffolder-node');
+var zod = require('zod');
+var topologyResolve = require('../../exporter/topologyResolve.cjs.js');
+var apiObjects = require('../../utils/api-objects.cjs.js');
+
+const stateBackendConfigSchema = zod.z.record(zod.z.string(), zod.z.string());
+const stateBackendSchema = zod.z.object({
+  type: zod.z.enum(["S3", "GCS", "AZURERM", "LOCAL", "POSTGRES", "REMOTE", "CLOUD"]),
+  config: stateBackendConfigSchema
+});
+const setStateBackendInputSchema = zod.z.object({
+  teamId: zod.z.string().min(1, "teamId is required"),
+  topologyId: zod.z.string().optional(),
+  appstackName: zod.z.string().optional(),
+  environmentName: zod.z.string().min(1, "environmentName is required"),
+  color: zod.z.string().optional().default("#000000"),
+  variables: zod.z.array(
+    zod.z.object({
+      name: zod.z.string(),
+      type: zod.z.string().optional().default("string"),
+      defaultValueJson: zod.z.string().optional(),
+      description: zod.z.string().optional()
+    })
+  ).optional().default([]),
+  /**
+   * Convenience input from VariableSelect: [{ name, value }] → string variables.
+   * Merged with `variables` when both are set.
+   */
+  variableValues: zod.z.array(
+    zod.z.object({
+      name: zod.z.string(),
+      value: zod.z.string()
+    })
+  ).optional().default([]),
+  stateBackend: stateBackendSchema
+}).superRefine((value, ctx) => {
+  if (!value.topologyId?.trim() && !value.appstackName?.trim()) {
+    ctx.addIssue({
+      code: zod.z.ZodIssueCode.custom,
+      message: "topologyId or appstackName is required",
+      path: ["topologyId"]
+    });
+  }
+});
+const setStateBackendOutputSchema = zod.z.object({
+  success: zod.z.boolean(),
+  environmentId: zod.z.string().optional()
+});
+const DEFAULT_PROJECT_MEMBER_ROLE_ID = "00000000-0000-0000-0000-000000000002";
+async function ensureProjectMembership(stackgenApis, teamId, logger) {
+  logger.info("Resolving PAT user via appcd auth API");
+  const meBody = await stackgenApis.authenticationApiObject.getMe();
+  const userId = String(meBody?.userId || "").trim();
+  if (!userId) {
+    throw new Error("auth/me response did not include userId");
+  }
+  logger.info(`Resolved PAT user: ${userId}`);
+  try {
+    await stackgenApis.projectApiObject.assignUsersToOrg({
+      orgId: teamId,
+      assignUsersToOrgRequest: {
+        userAssignments: [
+          { userId, roleId: DEFAULT_PROJECT_MEMBER_ROLE_ID }
+        ]
+      }
+    });
+  } catch (error) {
+    const parsedError = await apiObjects.readClientError(error);
+    const detail = apiObjects.formatApiFailure(
+      parsedError.status,
+      parsedError.body,
+      parsedError.text,
+      parsedError.requestId
+    );
+    if (detail.toLowerCase().includes("already") || parsedError.text.toLowerCase().includes("already") || parsedError.status === 409) {
+      logger.info(`PAT user ${userId} already a member of project ${teamId}`);
+      return { userId, wasAdded: false };
+    }
+    throw new Error(`Failed to add PAT user to project: ${detail}`);
+  }
+  logger.info(`Added PAT user ${userId} to project ${teamId}`);
+  return { userId, wasAdded: true };
+}
+const setStateBackendAction = (config, logger) => {
+  return pluginScaffolderNode.createTemplateAction({
+    id: "stackGen:setStateBackend",
+    description: "Creates an environment profile with a Terraform state backend (e.g. S3) on a StackGen topology",
+    schema: {
+      // Backstage parseSchemas only accepts (z) => ZodType or per-field callbacks.
+      input: () => setStateBackendInputSchema,
+      output: () => setStateBackendOutputSchema
+    },
+    async handler(ctx) {
+      const stackgenApis = apiObjects.getStackgenApiObjects(config);
+      const {
+        teamId,
+        topologyId: topologyIdInput,
+        appstackName,
+        environmentName,
+        color,
+        variables,
+        variableValues,
+        stateBackend
+      } = ctx.input;
+      let topologyId = topologyIdInput?.trim() || "";
+      if (!topologyId) {
+        topologyId = await topologyResolve.resolveTopologyId({
+          config,
+          teamId,
+          appstackName: appstackName?.trim()});
+      }
+      const fromSelect = (variableValues || []).map((pair) => ({
+        name: pair.name,
+        type: "string",
+        defaultValueJson: JSON.stringify(pair.value),
+        description: `Set via VariableSelect (${pair.name})`
+      }));
+      const mergedVariables = [...variables || [], ...fromSelect];
+      ctx.logger.info(`Ensuring PAT user has access to project ${teamId}`);
+      await ensureProjectMembership(stackgenApis, teamId, logger);
+      const payload = {
+        profileName: environmentName,
+        color,
+        topologyId,
+        variables: mergedVariables,
+        stateBackend: {
+          id: "",
+          type: stateBackend.type,
+          config: stateBackend.config,
+          editorMode: false
+        }
+      };
+      ctx.logger.info(
+        `Creating environment '${environmentName}' with ${stateBackend.type} state backend`
+      );
+      logger.info(
+        `stackGen:setStateBackend via generated client (env=${environmentName}, type=${stateBackend.type})`
+      );
+      try {
+        const body = await stackgenApis.v1EnvironmentProfileApiObj.createEnvProfile({
+          orgId: teamId,
+          envProfileRequest: payload
+        });
+        const envId = body?.id || body?.environmentId || "";
+        ctx.logger.info(
+          `\u2713 Environment '${environmentName}' created with ${stateBackend.type} state backend (ID: ${envId})`
+        );
+        ctx.output("success", true);
+        ctx.output("environmentId", envId);
+      } catch (error) {
+        const parsedError = await apiObjects.readClientError(error);
+        const detail = apiObjects.formatApiFailure(
+          parsedError.status,
+          parsedError.body,
+          parsedError.text,
+          parsedError.requestId
+        );
+        ctx.logger.error(
+          `Failed to create environment with state backend: ${detail}`
+        );
+        throw new Error(
+          `Failed to create environment '${environmentName}' with state backend: ${detail}`
+        );
+      }
+    }
+  });
+};
+
+exports.setStateBackendAction = setStateBackendAction;
+exports.setStateBackendInputSchema = setStateBackendInputSchema;
+exports.setStateBackendOutputSchema = setStateBackendOutputSchema;
+//# sourceMappingURL=set_state_backend_action.cjs.js.map

package/dist/actions/core/set_state_backend_action.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set_state_backend_action.cjs.js","sources":["../../../src/actions/core/set_state_backend_action.ts"],"sourcesContent":["import { createTemplateAction } from \"@backstage/plugin-scaffolder-node\";\nimport { LoggerService } from \"@backstage/backend-plugin-api\";\nimport { Config } from \"@backstage/config\";\nimport { z } from \"zod\";\nimport { resolveTopologyId } from \"../../exporter/topologyResolve\";\nimport {\n  formatApiFailure,\n  getStackgenApiObjects,\n  readClientError,\n} from \"../../utils/api-objects\";\n\n// --- Schemas ---\n\nconst stateBackendConfigSchema = z.record(z.string(), z.string());\n\nconst stateBackendSchema = z.object({\n    type: z.enum([\"S3\", \"GCS\", \"AZURERM\", \"LOCAL\", \"POSTGRES\", \"REMOTE\", \"CLOUD\"]),\n    config: stateBackendConfigSchema,\n});\n\nexport const setStateBackendInputSchema = z\n    .object({\n        teamId: z.string().min(1, \"teamId is required\"),\n        topologyId: z.string().optional(),\n        appstackName: z.string().optional(),\n        environmentName: z.string().min(1, \"environmentName is required\"),\n        color: z.string().optional().default(\"#000000\"),\n        variables: z\n            .array(\n                z.object({\n                    name: z.string(),\n                    type: z.string().optional().default(\"string\"),\n                    defaultValueJson: z.string().optional(),\n                    description: z.string().optional(),\n                }),\n            )\n            .optional()\n            .default([]),\n        /**\n         * Convenience input from VariableSelect: [{ name, value }] → string variables.\n         * Merged with `variables` when both are set.\n         */\n        variableValues: z\n            .array(\n                z.object({\n                    name: z.string(),\n                    value: z.string(),\n                }),\n            )\n            .optional()\n            .default([]),\n        stateBackend: stateBackendSchema,\n    })\n    .superRefine((value, ctx) => {\n        if (!value.topologyId?.trim() && !value.appstackName?.trim()) {\n            ctx.addIssue({\n                code: z.ZodIssueCode.custom,\n                message: \"topologyId or appstackName is required\",\n                path: [\"topologyId\"],\n            });\n        }\n    });\n\nexport const setStateBackendOutputSchema = z.object({\n    success: z.boolean(),\n    environmentId: z.string().optional(),\n});\n\n// --- Helpers ---\n\nconst DEFAULT_PROJECT_MEMBER_ROLE_ID = \"00000000-0000-0000-0000-000000000002\";\n\n/**\n * Resolves the PAT user and ensures they are a member of the project,\n * matching the pattern used in createAppStackAction.\n */\nasync function ensureProjectMembership(\n    stackgenApis: ReturnType<typeof getStackgenApiObjects>,\n    teamId: string,\n    logger: LoggerService,\n): Promise<{ userId: string; wasAdded: boolean }> {\n    // Step 1: Resolve PAT user\n    logger.info(\"Resolving PAT user via appcd auth API\");\n    const meBody = await stackgenApis.authenticationApiObject.getMe();\n    const userId = String(meBody?.userId || \"\").trim();\n    if (!userId) {\n        throw new Error(\"auth/me response did not include userId\");\n    }\n    logger.info(`Resolved PAT user: ${userId}`);\n\n    // Step 2: Add user to project\n    try {\n        await stackgenApis.projectApiObject.assignUsersToOrg({\n            orgId: teamId,\n            assignUsersToOrgRequest: {\n                userAssignments: [\n                    { userId, roleId: DEFAULT_PROJECT_MEMBER_ROLE_ID },\n                ],\n            } as never,\n        });\n    } catch (error) {\n        const parsedError = await readClientError(error);\n        const detail = formatApiFailure(\n            parsedError.status,\n            parsedError.body,\n            parsedError.text,\n            parsedError.requestId,\n        );\n        // \"already a member\" is fine\n        if (\n            detail.toLowerCase().includes(\"already\") ||\n            parsedError.text.toLowerCase().includes(\"already\") ||\n            parsedError.status === 409\n        ) {\n            logger.info(`PAT user ${userId} already a member of project ${teamId}`);\n            return { userId, wasAdded: false };\n        }\n        throw new Error(`Failed to add PAT user to project: ${detail}`);\n    }\n\n    logger.info(`Added PAT user ${userId} to project ${teamId}`);\n    return { userId, wasAdded: true };\n}\n\n// --- Action ---\n// Creates an environment profile on a topology with a state backend configuration.\n// Mirrors the functional test flow:\n//   1. Resolve PAT user & add to project (for iac-gen API access)\n//   2. POST /iac-gen/v1/environment-profile?orgId={teamId}\n//      body: { profileName, color, topologyId, variables, stateBackend }\n\nexport const setStateBackendAction = (config: Config, logger: LoggerService) => {\n    return createTemplateAction({\n        id: \"stackGen:setStateBackend\",\n        description:\n            \"Creates an environment profile with a Terraform state backend (e.g. S3) on a StackGen topology\",\n        schema: {\n            // Backstage parseSchemas only accepts (z) => ZodType or per-field callbacks.\n            input: () => setStateBackendInputSchema,\n            output: () => setStateBackendOutputSchema,\n        },\n        async handler(ctx) {\n            const stackgenApis = getStackgenApiObjects(config);\n\n            const {\n                teamId,\n                topologyId: topologyIdInput,\n                appstackName,\n                environmentName,\n                color,\n                variables,\n                variableValues,\n                stateBackend,\n            } = ctx.input;\n\n            let topologyId = topologyIdInput?.trim() || \"\";\n            if (!topologyId) {\n                topologyId = await resolveTopologyId({\n                    config,\n                    teamId,\n                    appstackName: appstackName?.trim(),\n                    logger,\n                });\n            }\n\n            const fromSelect = (variableValues || []).map((pair) => ({\n                name: pair.name,\n                type: \"string\",\n                defaultValueJson: JSON.stringify(pair.value),\n                description: `Set via VariableSelect (${pair.name})`,\n            }));\n            const mergedVariables = [...(variables || []), ...fromSelect];\n\n            // Step 0: Ensure PAT user has access to project\n            ctx.logger.info(`Ensuring PAT user has access to project ${teamId}`);\n            await ensureProjectMembership(stackgenApis, teamId, logger);\n\n            // Step 1: POST to create environment profile with state backend\n            const payload = {\n                profileName: environmentName,\n                color,\n                topologyId,\n                variables: mergedVariables,\n                stateBackend: {\n                    id: \"\",\n                    type: stateBackend.type,\n                    config: stateBackend.config,\n                    editorMode: false,\n                },\n            };\n\n            ctx.logger.info(\n                `Creating environment '${environmentName}' with ${stateBackend.type} state backend`,\n            );\n            logger.info(\n                `stackGen:setStateBackend via generated client (env=${environmentName}, type=${stateBackend.type})`,\n            );\n\n            try {\n                const body = (await stackgenApis.v1EnvironmentProfileApiObj.createEnvProfile({\n                    orgId: teamId,\n                    envProfileRequest: payload as never,\n                })) as { id?: string; environmentId?: string };\n                const envId = body?.id || body?.environmentId || \"\";\n                ctx.logger.info(\n                    `✓ Environment '${environmentName}' created with ${stateBackend.type} state backend (ID: ${envId})`,\n                );\n                ctx.output(\"success\", true);\n                ctx.output(\"environmentId\", envId);\n            } catch (error) {\n                const parsedError = await readClientError(error);\n                const detail = formatApiFailure(\n                    parsedError.status,\n                    parsedError.body,\n                    parsedError.text,\n                    parsedError.requestId,\n                );\n                ctx.logger.error(\n                    `Failed to create environment with state backend: ${detail}`,\n                );\n                throw new Error(\n                    `Failed to create environment '${environmentName}' with state backend: ${detail}`,\n                );\n            }\n        },\n    });\n};\n"],"names":["z","readClientError","formatApiFailure","createTemplateAction","getStackgenApiObjects","resolveTopologyId"],"mappings":";;;;;;;AAaA,MAAM,wBAAA,GAA2BA,MAAE,MAAA,CAAOA,KAAA,CAAE,QAAO,EAAGA,KAAA,CAAE,QAAQ,CAAA;AAEhE,MAAM,kBAAA,GAAqBA,MAAE,MAAA,CAAO;AAAA,EAChC,IAAA,EAAMA,KAAA,CAAE,IAAA,CAAK,CAAC,IAAA,EAAM,KAAA,EAAO,SAAA,EAAW,OAAA,EAAS,UAAA,EAAY,QAAA,EAAU,OAAO,CAAC,CAAA;AAAA,EAC7E,MAAA,EAAQ;AACZ,CAAC,CAAA;AAEM,MAAM,0BAAA,GAA6BA,MACrC,MAAA,CAAO;AAAA,EACJ,QAAQA,KAAA,CAAE,MAAA,EAAO,CAAE,GAAA,CAAI,GAAG,oBAAoB,CAAA;AAAA,EAC9C,UAAA,EAAYA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAChC,YAAA,EAAcA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAClC,iBAAiBA,KAAA,CAAE,MAAA,EAAO,CAAE,GAAA,CAAI,GAAG,6BAA6B,CAAA;AAAA,EAChE,OAAOA,KAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,QAAQ,SAAS,CAAA;AAAA,EAC9C,WAAWA,KAAA,CACN,KAAA;AAAA,IACGA,MAAE,MAAA,CAAO;AAAA,MACL,IAAA,EAAMA,MAAE,MAAA,EAAO;AAAA,MACf,MAAMA,KAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,QAAQ,QAAQ,CAAA;AAAA,MAC5C,gBAAA,EAAkBA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,MACtC,WAAA,EAAaA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AAAS,KACpC;AAAA,GACL,CACC,QAAA,EAAS,CACT,OAAA,CAAQ,EAAE,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAKf,gBAAgBA,KAAA,CACX,KAAA;AAAA,IACGA,MAAE,MAAA,CAAO;AAAA,MACL,IAAA,EAAMA,MAAE,MAAA,EAAO;AAAA,MACf,KAAA,EAAOA,MAAE,MAAA;AAAO,KACnB;AAAA,GACL,CACC,QAAA,EAAS,CACT,OAAA,CAAQ,EAAE,CAAA;AAAA,EACf,YAAA,EAAc;AAClB,CAAC,CAAA,CACA,WAAA,CAAY,CAAC,KAAA,EAAO,GAAA,KAAQ;AACzB,EAAA,IAAI,CAAC,MAAM,UAAA,EAAY,IAAA,MAAU,CAAC,KAAA,CAAM,YAAA,EAAc,IAAA,EAAK,EAAG;AAC1D,IAAA,GAAA,CAAI,QAAA,CAAS;AAAA,MACT,IAAA,EAAMA,MAAE,YAAA,CAAa,MAAA;AAAA,MACrB,OAAA,EAAS,wCAAA;AAAA,MACT,IAAA,EAAM,CAAC,YAAY;AAAA,KACtB,CAAA;AAAA,EACL;AACJ,CAAC;AAEE,MAAM,2BAAA,GAA8BA,MAAE,MAAA,CAAO;AAAA,EAChD,OAAA,EAASA,MAAE,OAAA,EAAQ;AAAA,EACnB,aAAA,EAAeA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AAC9B,CAAC;AAID,MAAM,8BAAA,GAAiC,sCAAA;AAMvC,eAAe,uBAAA,CACX,YAAA,EACA,MAAA,EACA,MAAA,EAC8C;AAE9C,EAAA,MAAA,CAAO,KAAK,uCAAuC,CAAA;AACnD,EAAA,MAAM,MAAA,GAAS,MAAM,YAAA,CAAa,uBAAA,CAAwB,KAAA,EAAM;AAChE,EAAA,MAAM,SAAS,MAAA,CAAO,MAAA,EAAQ,MAAA,IAAU,EAAE,EAAE,IAAA,EAAK;AACjD,EAAA,IAAI,CAAC,MAAA,EAAQ;AACT,IAAA,MAAM,IAAI,MAAM,yCAAyC,CAAA;AAAA,EAC7D;AACA,EAAA,MAAA,CAAO,IAAA,CAAK,CAAA,mBAAA,EAAsB,MAAM,CAAA,CAAE,CAAA;AAG1C,EAAA,IAAI;AACA,IAAA,MAAM,YAAA,CAAa,iBAAiB,gBAAA,CAAiB;AAAA,MACjD,KAAA,EAAO,MAAA;AAAA,MACP,uBAAA,EAAyB;AAAA,QACrB,eAAA,EAAiB;AAAA,UACb,EAAE,MAAA,EAAQ,MAAA,EAAQ,8BAAA;AAA+B;AACrD;AACJ,KACH,CAAA;AAAA,EACL,SAAS,KAAA,EAAO;AACZ,IAAA,MAAM,WAAA,GAAc,MAAMC,0BAAA,CAAgB,KAAK,CAAA;AAC/C,IAAA,MAAM,MAAA,GAASC,2BAAA;AAAA,MACX,WAAA,CAAY,MAAA;AAAA,MACZ,WAAA,CAAY,IAAA;AAAA,MACZ,WAAA,CAAY,IAAA;AAAA,MACZ,WAAA,CAAY;AAAA,KAChB;AAEA,IAAA,IACI,MAAA,CAAO,WAAA,EAAY,CAAE,QAAA,CAAS,SAAS,CAAA,IACvC,WAAA,CAAY,IAAA,CAAK,WAAA,GAAc,QAAA,CAAS,SAAS,CAAA,IACjD,WAAA,CAAY,WAAW,GAAA,EACzB;AACE,MAAA,MAAA,CAAO,IAAA,CAAK,CAAA,SAAA,EAAY,MAAM,CAAA,6BAAA,EAAgC,MAAM,CAAA,CAAE,CAAA;AACtE,MAAA,OAAO,EAAE,MAAA,EAAQ,QAAA,EAAU,KAAA,EAAM;AAAA,IACrC;AACA,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,mCAAA,EAAsC,MAAM,CAAA,CAAE,CAAA;AAAA,EAClE;AAEA,EAAA,MAAA,CAAO,IAAA,CAAK,CAAA,eAAA,EAAkB,MAAM,CAAA,YAAA,EAAe,MAAM,CAAA,CAAE,CAAA;AAC3D,EAAA,OAAO,EAAE,MAAA,EAAQ,QAAA,EAAU,IAAA,EAAK;AACpC;AASO,MAAM,qBAAA,GAAwB,CAAC,MAAA,EAAgB,MAAA,KAA0B;AAC5E,EAAA,OAAOC,yCAAA,CAAqB;AAAA,IACxB,EAAA,EAAI,0BAAA;AAAA,IACJ,WAAA,EACI,gGAAA;AAAA,IACJ,MAAA,EAAQ;AAAA;AAAA,MAEJ,OAAO,MAAM,0BAAA;AAAA,MACb,QAAQ,MAAM;AAAA,KAClB;AAAA,IACA,MAAM,QAAQ,GAAA,EAAK;AACf,MAAA,MAAM,YAAA,GAAeC,iCAAsB,MAAM,CAAA;AAEjD,MAAA,MAAM;AAAA,QACF,MAAA;AAAA,QACA,UAAA,EAAY,eAAA;AAAA,QACZ,YAAA;AAAA,QACA,eAAA;AAAA,QACA,KAAA;AAAA,QACA,SAAA;AAAA,QACA,cAAA;AAAA,QACA;AAAA,UACA,GAAA,CAAI,KAAA;AAER,MAAA,IAAI,UAAA,GAAa,eAAA,EAAiB,IAAA,EAAK,IAAK,EAAA;AAC5C,MAAA,IAAI,CAAC,UAAA,EAAY;AACb,QAAA,UAAA,GAAa,MAAMC,iCAAA,CAAkB;AAAA,UACjC,MAAA;AAAA,UACA,MAAA;AAAA,UACA,YAAA,EAAc,cAAc,IAAA,EAEhC,CAAC,CAAA;AAAA,MACL;AAEA,MAAA,MAAM,cAAc,cAAA,IAAkB,EAAC,EAAG,GAAA,CAAI,CAAC,IAAA,MAAU;AAAA,QACrD,MAAM,IAAA,CAAK,IAAA;AAAA,QACX,IAAA,EAAM,QAAA;AAAA,QACN,gBAAA,EAAkB,IAAA,CAAK,SAAA,CAAU,IAAA,CAAK,KAAK,CAAA;AAAA,QAC3C,WAAA,EAAa,CAAA,wBAAA,EAA2B,IAAA,CAAK,IAAI,CAAA,CAAA;AAAA,OACrD,CAAE,CAAA;AACF,MAAA,MAAM,kBAAkB,CAAC,GAAI,aAAa,EAAC,EAAI,GAAG,UAAU,CAAA;AAG5D,MAAA,GAAA,CAAI,MAAA,CAAO,IAAA,CAAK,CAAA,wCAAA,EAA2C,MAAM,CAAA,CAAE,CAAA;AACnE,MAAA,MAAM,uBAAA,CAAwB,YAAA,EAAc,MAAA,EAAQ,MAAM,CAAA;AAG1D,MAAA,MAAM,OAAA,GAAU;AAAA,QACZ,WAAA,EAAa,eAAA;AAAA,QACb,KAAA;AAAA,QACA,UAAA;AAAA,QACA,SAAA,EAAW,eAAA;AAAA,QACX,YAAA,EAAc;AAAA,UACV,EAAA,EAAI,EAAA;AAAA,UACJ,MAAM,YAAA,CAAa,IAAA;AAAA,UACnB,QAAQ,YAAA,CAAa,MAAA;AAAA,UACrB,UAAA,EAAY;AAAA;AAChB,OACJ;AAEA,MAAA,GAAA,CAAI,MAAA,CAAO,IAAA;AAAA,QACP,CAAA,sBAAA,EAAyB,eAAe,CAAA,OAAA,EAAU,YAAA,CAAa,IAAI,CAAA,cAAA;AAAA,OACvE;AACA,MAAA,MAAA,CAAO,IAAA;AAAA,QACH,CAAA,mDAAA,EAAsD,eAAe,CAAA,OAAA,EAAU,YAAA,CAAa,IAAI,CAAA,CAAA;AAAA,OACpG;AAEA,MAAA,IAAI;AACA,QAAA,MAAM,IAAA,GAAQ,MAAM,YAAA,CAAa,0BAAA,CAA2B,gBAAA,CAAiB;AAAA,UACzE,KAAA,EAAO,MAAA;AAAA,UACP,iBAAA,EAAmB;AAAA,SACtB,CAAA;AACD,QAAA,MAAM,KAAA,GAAQ,IAAA,EAAM,EAAA,IAAM,IAAA,EAAM,aAAA,IAAiB,EAAA;AACjD,QAAA,GAAA,CAAI,MAAA,CAAO,IAAA;AAAA,UACP,uBAAkB,eAAe,CAAA,eAAA,EAAkB,YAAA,CAAa,IAAI,uBAAuB,KAAK,CAAA,CAAA;AAAA,SACpG;AACA,QAAA,GAAA,CAAI,MAAA,CAAO,WAAW,IAAI,CAAA;AAC1B,QAAA,GAAA,CAAI,MAAA,CAAO,iBAAiB,KAAK,CAAA;AAAA,MACrC,SAAS,KAAA,EAAO;AACZ,QAAA,MAAM,WAAA,GAAc,MAAMJ,0BAAA,CAAgB,KAAK,CAAA;AAC/C,QAAA,MAAM,MAAA,GAASC,2BAAA;AAAA,UACX,WAAA,CAAY,MAAA;AAAA,UACZ,WAAA,CAAY,IAAA;AAAA,UACZ,WAAA,CAAY,IAAA;AAAA,UACZ,WAAA,CAAY;AAAA,SAChB;AACA,QAAA,GAAA,CAAI,MAAA,CAAO,KAAA;AAAA,UACP,oDAAoD,MAAM,CAAA;AAAA,SAC9D;AACA,QAAA,MAAM,IAAI,KAAA;AAAA,UACN,CAAA,8BAAA,EAAiC,eAAe,CAAA,sBAAA,EAAyB,MAAM,CAAA;AAAA,SACnF;AAAA,MACJ;AAAA,IACJ;AAAA,GACH,CAAA;AACL;;;;;;"}

package/dist/actions/exporter/export_iac_to_git_action.cjs.js

@@ -0,0 +1,290 @@
+'use strict';
+
+var pluginScaffolderNode = require('@backstage/plugin-scaffolder-node');
+var zod = require('zod');
+var topologyResolve = require('../../exporter/topologyResolve.cjs.js');
+var gitExporterConfigHttp = require('../../exporter/gitExporterConfigHttp.cjs.js');
+var projectGitExporterTemplate = require('../../exporter/projectGitExporterTemplate.cjs.js');
+var exportOverrides = require('../../exporter/exportOverrides.cjs.js');
+var apiObjects = require('../../utils/api-objects.cjs.js');
+
+const exportBootstrapGitConfigSchema = zod.z.object({
+  name: zod.z.string().optional(),
+  type: zod.z.string().optional(),
+  parameters: zod.z.object({
+    scmType: zod.z.string().min(1),
+    repoUrl: zod.z.string().min(1),
+    targetBranch: zod.z.string().optional(),
+    path: zod.z.string().optional()
+  }),
+  vaultReference: zod.z.string().min(1),
+  default: zod.z.boolean().optional()
+});
+const exportToGitInputSchema = zod.z.object({
+  appstackName: zod.z.string().min(1),
+  teamId: zod.z.string().min(1),
+  appstackId: zod.z.string().optional(),
+  topologyId: zod.z.string().optional(),
+  /**
+   * When set (non-empty), used as stack-exporter git `config_id`; skips listing and bootstrap.
+   * Precedence: configId overrides gitConfig.
+   */
+  configId: zod.z.string().optional(),
+  /**
+   * Optional bootstrap override. If omitted and no usable appstack config exists, the action loads
+   * the project default git template and POSTs an appstack-scoped git config.
+   * Ignored when configId is set.
+   */
+  gitConfig: exportBootstrapGitConfigSchema.optional(),
+  /**
+   * First-class git export controls (parity with the StackGen UI). Each maps to a
+   * stack-exporter override key via `buildExportOverrides`; explicit `overrides`
+   * entries for the same key win.
+   */
+  // Branch to base the change on (PR base / commit destination) -> `target_branch`.
+  baseBranch: zod.z.string().optional(),
+  // Branch StackGen pushes changes to (source/head branch) -> `branch_format`.
+  pushBranch: zod.z.string().optional(),
+  /**
+   * When true, reuse the previous export push branch (`use_same_branch`).
+   * Set by ExporterPushBranch when the field was prefilled from history and left unchanged.
+   */
+  useSameBranch: zod.z.boolean().optional(),
+  // When false, commit directly to the branch without opening a PR (`commit_only`). Defaults to creating a PR.
+  createPr: zod.z.boolean().optional(),
+  overrides: zod.z.array(
+    zod.z.object({
+      key: zod.z.string(),
+      value: zod.z.string()
+    })
+  ).optional()
+});
+const exportToGitOutputSchema = zod.z.object({
+  // Optional because a commit-only export (createPr=false) does not open a pull request.
+  pullRequestUrl: zod.z.string().url().optional(),
+  externalLink: zod.z.string().url().optional(),
+  // Populated for commit-only exports: the branch StackGen committed the changes to.
+  committedBranch: zod.z.string().optional(),
+  // Human-readable notes from stack-exporter (e.g. "committed to branch X").
+  notes: zod.z.string().optional()
+});
+function normalizeConfig(raw) {
+  if (!raw || typeof raw !== "object") {
+    return void 0;
+  }
+  return raw;
+}
+function chooseConfig(configs, appstackName) {
+  const gitOnly = configs.filter((c) => (c.type ?? "").toLowerCase() === "git");
+  const defaults = gitOnly.filter((c) => c.default);
+  if (defaults.length === 1) {
+    return defaults[0];
+  }
+  if (defaults.length > 1) {
+    throw new Error(
+      `Multiple default git exporter configs found for "${appstackName}". Pass configId (ExporterGitConfigSelect) or gitConfig on stackGen:exportToGit, or reduce configs in stack-exporter.`
+    );
+  }
+  if (gitOnly.length === 1) {
+    return gitOnly[0];
+  }
+  if (gitOnly.length > 1) {
+    throw new Error(
+      `Multiple git exporter configs found for "${appstackName}". Pass configId (ExporterGitConfigSelect) or gitConfig on stackGen:exportToGit, or mark one config as default in stack-exporter.`
+    );
+  }
+  return void 0;
+}
+function isCompleteGitConfig(gc) {
+  return Boolean(gc?.parameters?.scmType && gc?.parameters?.repoUrl && gc?.vaultReference);
+}
+function asExportResponse(raw) {
+  return raw && typeof raw === "object" ? raw : {};
+}
+function parsePrUrl(raw) {
+  const data = asExportResponse(raw);
+  const direct = typeof data.externalLink === "string" ? data.externalLink.trim() : "";
+  const notes = typeof data.notes === "string" ? data.notes : "";
+  const fromNotes = notes.match(/https?:\/\/[^\s"',)>\]]+/i)?.[0] ?? "";
+  const url = (direct || fromNotes).trim();
+  return url || void 0;
+}
+function parseCommittedBranch(raw) {
+  const data = asExportResponse(raw);
+  const head = typeof data.metadata?.head === "string" ? data.metadata.head.trim() : "";
+  return head || void 0;
+}
+function parseNotes(raw) {
+  const data = asExportResponse(raw);
+  const notes = typeof data.notes === "string" ? data.notes.trim() : "";
+  return notes || void 0;
+}
+async function bootstrapGitConfig(params) {
+  const { config, teamId, appstackId, appstackName, gitConfig: gc, logger } = params;
+  let bootstrap;
+  if (isCompleteGitConfig(gc)) {
+    bootstrap = {
+      name: gc.name?.trim() || "default-git-config",
+      scmType: gc.parameters.scmType,
+      repoUrl: gc.parameters.repoUrl,
+      targetBranch: gc.parameters.targetBranch ?? "main",
+      path: gc.parameters.path ?? "/",
+      tokenRef: gc.vaultReference
+    };
+  } else {
+    const templateBody = await projectGitExporterTemplate.fetchProjectGitTemplates(config, teamId, logger);
+    bootstrap = projectGitExporterTemplate.chooseGitTemplateFromTemplatesResponse(templateBody);
+  }
+  if (!bootstrap) {
+    throw new Error(
+      `No git exporter config found for appstack "${appstackName}" and team "${teamId}", and no usable project git template (GET exporter /config/template). Ensure createProject included gitConfig, or pass gitConfig / configId on this action.`
+    );
+  }
+  if (!appstackId?.trim()) {
+    throw new Error(
+      `Cannot create git exporter config for "${appstackName}": appstackId is required so the config is bound to the AppStack.`
+    );
+  }
+  const createdId = await gitExporterConfigHttp.createGitExporterConfiguration(
+    config,
+    {
+      orgId: teamId,
+      name: bootstrap.name,
+      appstackId,
+      scmType: bootstrap.scmType,
+      repoUrl: bootstrap.repoUrl,
+      targetBranch: bootstrap.targetBranch,
+      path: bootstrap.path,
+      secrets: { token_ref: bootstrap.tokenRef }
+    },
+    logger
+  );
+  const usedExplicitGitConfig = isCompleteGitConfig(gc);
+  logger.info(
+    `Created git exporter config "${createdId}" for appstack "${appstackId}" (${usedExplicitGitConfig ? "explicit gitConfig input" : "project default git template"})`
+  );
+  return createdId;
+}
+const exportAppStackToGitAction = (config, _logger) => {
+  return pluginScaffolderNode.createTemplateAction({
+    id: "stackGen:exportToGit",
+    description: "Exports an AppStack via stack-exporter (resolve topology, select or bootstrap appstack-scoped git config, run export)",
+    schema: {
+      // Backstage parseSchemas only accepts (z) => ZodType or per-field callbacks.
+      input: () => exportToGitInputSchema,
+      output: () => exportToGitOutputSchema
+    },
+    async handler(ctx) {
+      try {
+        const { appstackName, teamId } = ctx.input;
+        const stackgenApis = apiObjects.getStackgenApiObjects(config);
+        const resolvedAppstackId = await topologyResolve.resolveExporterAppstackId({
+          config,
+          teamId,
+          appstackId: ctx.input.appstackId,
+          appstackName,
+          logger: ctx.logger
+        });
+        const topologyId = ctx.input.topologyId?.trim() || await topologyResolve.resolveTopologyId({
+          config,
+          teamId,
+          appstackId: ctx.input.appstackId,
+          appstackName,
+          logger: ctx.logger
+        });
+        if (!topologyId) {
+          throw new Error(
+            `Could not resolve topologyId for appstack "${appstackName}" in team "${teamId}". Pass topologyId on stackGen:exportToGit or ensure the appstack exists in appcd /appstacks.`
+          );
+        }
+        const explicitConfigId = ctx.input.configId?.trim();
+        let selectedConfigId = explicitConfigId || void 0;
+        if (!selectedConfigId && isCompleteGitConfig(ctx.input.gitConfig)) {
+          selectedConfigId = await bootstrapGitConfig({
+            config,
+            teamId,
+            appstackId: resolvedAppstackId,
+            appstackName,
+            gitConfig: ctx.input.gitConfig,
+            logger: ctx.logger
+          });
+        }
+        if (!selectedConfigId) {
+          const list = await gitExporterConfigHttp.listGitExporterConfigs(
+            config,
+            {
+              orgId: teamId,
+              type: "git",
+              appstackId: resolvedAppstackId
+            },
+            ctx.logger
+          );
+          const configs = list.map(normalizeConfig).filter((c) => Boolean(c?.id));
+          const selected = chooseConfig(configs, appstackName);
+          if (selected?.id) {
+            selectedConfigId = selected.id;
+          } else {
+            selectedConfigId = await bootstrapGitConfig({
+              config,
+              teamId,
+              appstackId: resolvedAppstackId,
+              appstackName,
+              gitConfig: ctx.input.gitConfig,
+              logger: ctx.logger
+            });
+          }
+        }
+        const overrides = exportOverrides.buildExportOverrides({
+          baseBranch: ctx.input.baseBranch,
+          pushBranch: ctx.input.pushBranch,
+          useSameBranch: ctx.input.useSameBranch,
+          createPr: ctx.input.createPr,
+          overrides: ctx.input.overrides
+        });
+        const exportRes = await stackgenApis.exporterApiObj.exportIAC({
+          orgId: teamId,
+          exportRequest: {
+            topologyId,
+            appstackName,
+            configId: selectedConfigId,
+            overrides
+          }
+        });
+        const prUrl = parsePrUrl(exportRes);
+        const committedBranch = parseCommittedBranch(exportRes);
+        const notes = parseNotes(exportRes);
+        if (ctx.input.createPr === false) {
+          if (committedBranch) {
+            ctx.output("committedBranch", committedBranch);
+          }
+          if (notes) {
+            ctx.output("notes", notes);
+          }
+          if (prUrl) {
+            ctx.output("pullRequestUrl", prUrl);
+            ctx.output("externalLink", prUrl);
+          }
+          return;
+        }
+        if (!prUrl) {
+          throw new Error("Export succeeded but no pull request URL was returned by stack-exporter");
+        }
+        ctx.output("pullRequestUrl", prUrl);
+        ctx.output("externalLink", prUrl);
+        if (committedBranch) {
+          ctx.output("committedBranch", committedBranch);
+        }
+        if (notes) {
+          ctx.output("notes", notes);
+        }
+      } catch (error) {
+        const detail = await apiObjects.formatClientErrorMessage(error);
+        ctx.logger.error(`Export to Git failed: ${detail}`);
+        throw new Error(`Export to Git failed: ${detail}`);
+      }
+    }
+  });
+};
+
+exports.exportAppStackToGitAction = exportAppStackToGitAction;
+//# sourceMappingURL=export_iac_to_git_action.cjs.js.map