@alienplatform/platform-api 1.3.4 → 1.4.0

package/src/models/package.ts

@@ -7,6 +7,10 @@ import { safeParse } from "../lib/schemas.js";
 import { ClosedEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import {
+  SetupFingerprintInfo,
+  SetupFingerprintInfo$inboundSchema,
+} from "./setupfingerprintinfo.js";
 
 /**
  * Types of packages that can be built
@@ -39,22 +43,22 @@ export const PackageStatus = {
 export type PackageStatus = ClosedEnum<typeof PackageStatus>;
 
 /**
- * Configuration for the Terraform provider binary
+ * Configuration for Terraform package generation.
  */
 export type ConfigTerraform = {
   /**
-   * Terraform provider name (e.g., "acme")
+   * Human-friendly application name shown in generated install artifacts.
    */
-  providerName: string;
+  displayName?: string | null | undefined;
   /**
-   * Terraform resource type name (e.g., "agent")
+   * AWS regions supported by the Alien environment that built this package.
    */
-  resourceType: string;
+  supportedAwsRegions?: Array<string> | undefined;
   type: "terraform";
 };
 
 /**
- * Branding configuration for the agent binary (white-labeling)
+ * Branding configuration for the agent binary.
  */
 export type ConfigAgentImage = {
   /**
@@ -87,11 +91,19 @@ export type ConfigHelm = {
  * Configuration for CloudFormation packages
  */
 export type ConfigCloudformation = {
+  /**
+   * Human-friendly application name shown in generated install artifacts.
+   */
+  displayName?: string | null | undefined;
+  /**
+   * AWS regions supported by the Alien environment that built this package.
+   */
+  supportedAwsRegions?: Array<string> | undefined;
   type: "cloudformation";
 };
 
 /**
- * Branding configuration for the deploy CLI binary (white-labeling)
+ * Branding configuration for the deploy CLI binary.
  */
 export type ConfigCli = {
   /**
@@ -115,6 +127,36 @@ export type Config =
   | ConfigAgentImage
   | ConfigTerraform;
 
+/**
+ * Information about a single Terraform module package for one target.
+ */
+export type PackageModules = {
+  /**
+   * Download URL for the module archive
+   */
+  downloadUrl: string;
+  /**
+   * Filename of the module archive
+   */
+  filename: string;
+  /**
+   * SHA256 checksum of the archive
+   */
+  shasum: string;
+  /**
+   * Size of the archive in bytes
+   */
+  size: number;
+  /**
+   * Terraform module source (hostname/namespace/name/provider, without scheme)
+   */
+  source: string;
+  /**
+   * Terraform module target (aws, gcp, azure, eks, gke, aks)
+   */
+  target: string;
+};
+
 /**
  * GPG public key for Terraform provider signature verification
  */
@@ -159,37 +201,48 @@ export type PackagePlatforms = {
   size: number;
 };
 
+/**
+ * Terraform provider registry outputs.
+ */
+export type PackageProvider = {
+  /**
+   * GPG public key for Terraform provider signature verification
+   */
+  gpgPublicKey: PackageGpgPublicKey;
+  /**
+   * Provider packages for each target platform
+   */
+  platforms: { [k: string]: PackagePlatforms };
+  /**
+   * Terraform provider source (hostname/namespace/type, without scheme)
+   */
+  source: string;
+};
+
 export const OutputsTypeTerraform = {
   Terraform: "terraform",
 } as const;
 export type OutputsTypeTerraform = ClosedEnum<typeof OutputsTypeTerraform>;
 
 /**
- * Outputs from a Terraform provider package build
+ * Outputs from a Terraform package build.
  */
 export type OutputsTerraform = {
   /**
-   * GPG public key for Terraform provider signature verification
+   * Module registry artifacts by Terraform target.
    */
-  gpgPublicKey: PackageGpgPublicKey;
+  modules: { [k: string]: PackageModules };
   /**
-   * Provider packages for each target platform
+   * Terraform provider registry outputs.
    */
-  platforms: { [k: string]: PackagePlatforms };
+  provider: PackageProvider;
   type: OutputsTypeTerraform;
 };
 
-export const OutputsTypeCloudformation = {
-  Cloudformation: "cloudformation",
-} as const;
-export type OutputsTypeCloudformation = ClosedEnum<
-  typeof OutputsTypeCloudformation
->;
-
 /**
- * Outputs from a CloudFormation package build
+ * Information about a single CloudFormation template package for one target.
  */
-export type OutputsCloudformation = {
+export type PackageTargets = {
   /**
    * AWS Console quick-launch URL
    */
@@ -202,10 +255,35 @@ export type OutputsCloudformation = {
    * Template size in bytes
    */
   size: number;
+  /**
+   * S3 URL to the CloudFormation stack policy
+   */
+  stackPolicyUrl: string;
+  /**
+   * CloudFormation target (aws, eks)
+   */
+  target: string;
   /**
    * S3 URL to the CloudFormation template
    */
   templateUrl: string;
+};
+
+export const OutputsTypeCloudformation = {
+  Cloudformation: "cloudformation",
+} as const;
+export type OutputsTypeCloudformation = ClosedEnum<
+  typeof OutputsTypeCloudformation
+>;
+
+/**
+ * Outputs from a CloudFormation package build.
+ */
+export type OutputsCloudformation = {
+  /**
+   * Template artifacts by CloudFormation target.
+   */
+  targets: { [k: string]: PackageTargets };
   type: OutputsTypeCloudformation;
 };
 
@@ -287,11 +365,11 @@ export type OutputsCli = {
  * Package outputs (only when status is 'ready')
  */
 export type PackageOutputsUnion =
-  | OutputsCloudformation
   | OutputsAgentImage
   | OutputsHelm
   | OutputsTerraform
   | OutputsCli
+  | OutputsCloudformation
   | any;
 
 export type Package = {
@@ -319,6 +397,18 @@ export type Package = {
    * Package version (e.g., '1.0.0', 'rel_abc123')
    */
   version: string;
+  /**
+   * Release used as package build input
+   */
+  sourceReleaseId: string;
+  /**
+   * Per-target setup compatibility fingerprints copied from the source release
+   */
+  setupFingerprints: { [k: string]: SetupFingerprintInfo };
+  /**
+   * Hash of Platform-known package build request inputs: package type, source release, setup fingerprints, package config, and setup contract version
+   */
+  packageBuildInputHash: string;
   /**
    * Type-specific configuration
    */
@@ -332,11 +422,11 @@ export type Package = {
    * Package outputs (only when status is 'ready')
    */
   outputs?:
-    | OutputsCloudformation
     | OutputsAgentImage
     | OutputsHelm
     | OutputsTerraform
     | OutputsCli
+    | OutputsCloudformation
     | any
     | null
     | undefined;
@@ -345,7 +435,7 @@ export type Package = {
    */
   error?: any | null | undefined;
   /**
-   * Source binary SHA256 (for cli/terraform packages)
+   * Builder-recorded source binary SHA256 (for cli/terraform packages)
    */
   sourceBinarySha256?: string | null | undefined;
   /**
@@ -372,8 +462,8 @@ export const ConfigTerraform$inboundSchema: z.ZodType<
   ConfigTerraform,
   unknown
 > = z.object({
-  providerName: z.string(),
-  resourceType: z.string(),
+  displayName: z.nullable(z.string()).optional(),
+  supportedAwsRegions: z.array(z.string()).optional(),
   type: z.literal("terraform"),
 });
 
@@ -430,6 +520,8 @@ export const ConfigCloudformation$inboundSchema: z.ZodType<
   ConfigCloudformation,
   unknown
 > = z.object({
+  displayName: z.nullable(z.string()).optional(),
+  supportedAwsRegions: z.array(z.string()).optional(),
   type: z.literal("cloudformation"),
 });
 
@@ -479,6 +571,27 @@ export function configFromJSON(
   );
 }
 
+/** @internal */
+export const PackageModules$inboundSchema: z.ZodType<PackageModules, unknown> =
+  z.object({
+    downloadUrl: z.string(),
+    filename: z.string(),
+    shasum: z.string(),
+    size: z.int(),
+    source: z.string(),
+    target: z.string(),
+  });
+
+export function packageModulesFromJSON(
+  jsonString: string,
+): SafeParseResult<PackageModules, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PackageModules$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PackageModules' from JSON`,
+  );
+}
+
 /** @internal */
 export const PackageGpgPublicKey$inboundSchema: z.ZodType<
   PackageGpgPublicKey,
@@ -521,6 +634,26 @@ export function packagePlatformsFromJSON(
   );
 }
 
+/** @internal */
+export const PackageProvider$inboundSchema: z.ZodType<
+  PackageProvider,
+  unknown
+> = z.object({
+  gpgPublicKey: z.lazy(() => PackageGpgPublicKey$inboundSchema),
+  platforms: z.record(z.string(), z.lazy(() => PackagePlatforms$inboundSchema)),
+  source: z.string(),
+});
+
+export function packageProviderFromJSON(
+  jsonString: string,
+): SafeParseResult<PackageProvider, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PackageProvider$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PackageProvider' from JSON`,
+  );
+}
+
 /** @internal */
 export const OutputsTypeTerraform$inboundSchema: z.ZodEnum<
   typeof OutputsTypeTerraform
@@ -531,8 +664,8 @@ export const OutputsTerraform$inboundSchema: z.ZodType<
   OutputsTerraform,
   unknown
 > = z.object({
-  gpgPublicKey: z.lazy(() => PackageGpgPublicKey$inboundSchema),
-  platforms: z.record(z.string(), z.lazy(() => PackagePlatforms$inboundSchema)),
+  modules: z.record(z.string(), z.lazy(() => PackageModules$inboundSchema)),
+  provider: z.lazy(() => PackageProvider$inboundSchema),
   type: OutputsTypeTerraform$inboundSchema,
 });
 
@@ -546,6 +679,27 @@ export function outputsTerraformFromJSON(
   );
 }
 
+/** @internal */
+export const PackageTargets$inboundSchema: z.ZodType<PackageTargets, unknown> =
+  z.object({
+    launchStackUrl: z.string(),
+    sha256: z.string(),
+    size: z.int(),
+    stackPolicyUrl: z.string(),
+    target: z.string(),
+    templateUrl: z.string(),
+  });
+
+export function packageTargetsFromJSON(
+  jsonString: string,
+): SafeParseResult<PackageTargets, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PackageTargets$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PackageTargets' from JSON`,
+  );
+}
+
 /** @internal */
 export const OutputsTypeCloudformation$inboundSchema: z.ZodEnum<
   typeof OutputsTypeCloudformation
@@ -556,10 +710,7 @@ export const OutputsCloudformation$inboundSchema: z.ZodType<
   OutputsCloudformation,
   unknown
 > = z.object({
-  launchStackUrl: z.string(),
-  sha256: z.string(),
-  size: z.int(),
-  templateUrl: z.string(),
+  targets: z.record(z.string(), z.lazy(() => PackageTargets$inboundSchema)),
   type: OutputsTypeCloudformation$inboundSchema,
 });
 
@@ -666,11 +817,11 @@ export const PackageOutputsUnion$inboundSchema: z.ZodType<
   PackageOutputsUnion,
   unknown
 > = z.union([
-  z.lazy(() => OutputsCloudformation$inboundSchema),
   z.lazy(() => OutputsAgentImage$inboundSchema),
   z.lazy(() => OutputsHelm$inboundSchema),
   z.lazy(() => OutputsTerraform$inboundSchema),
   z.lazy(() => OutputsCli$inboundSchema),
+  z.lazy(() => OutputsCloudformation$inboundSchema),
   z.any(),
 ]);
 
@@ -692,6 +843,9 @@ export const Package$inboundSchema: z.ZodType<Package, unknown> = z.object({
   type: PackageTypeEnum$inboundSchema,
   status: PackageStatus$inboundSchema,
   version: z.string(),
+  sourceReleaseId: z.string(),
+  setupFingerprints: z.record(z.string(), SetupFingerprintInfo$inboundSchema),
+  packageBuildInputHash: z.string(),
   config: z.union([
     z.lazy(() => ConfigCli$inboundSchema),
     z.lazy(() => ConfigCloudformation$inboundSchema),
@@ -701,11 +855,11 @@ export const Package$inboundSchema: z.ZodType<Package, unknown> = z.object({
   ]),
   outputs: z.nullable(
     z.union([
-      z.lazy(() => OutputsCloudformation$inboundSchema),
       z.lazy(() => OutputsAgentImage$inboundSchema),
       z.lazy(() => OutputsHelm$inboundSchema),
       z.lazy(() => OutputsTerraform$inboundSchema),
       z.lazy(() => OutputsCli$inboundSchema),
+      z.lazy(() => OutputsCloudformation$inboundSchema),
       z.any(),
     ]),
   ).optional(),