@alienplatform/manager-api 1.3.4 → 1.4.0

package/src/models/stackimportrequest.ts

@@ -0,0 +1,154 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4";
+import {
+  ImportedResource,
+  ImportedResource$Outbound,
+  ImportedResource$outboundSchema,
+} from "./importedresource.js";
+import {
+  ImportSourceKind,
+  ImportSourceKind$outboundSchema,
+} from "./importsourcekind.js";
+import {
+  ManagementConfig,
+  ManagementConfig$Outbound,
+  ManagementConfig$outboundSchema,
+} from "./managementconfig.js";
+import { PlatformEnum, PlatformEnum$outboundSchema } from "./platformenum.js";
+import {
+  StackSettings,
+  StackSettings$Outbound,
+  StackSettings$outboundSchema,
+} from "./stacksettings.js";
+
+/**
+ * Request body for manager-side stack import.
+ */
+export type StackImportRequest = {
+  basePlatform?: PlatformEnum | null | undefined;
+  /**
+   * Deployment-group token authorizing the import.
+   */
+  deploymentGroupToken: string;
+  /**
+   * User-chosen deployment name. Must be unique within the deployment
+   *
+   * @remarks
+   * group; the manager returns 409 on collision rather than silently
+   * resolving to an existing deployment. Each setup adapter picks
+   * the natural source: CloudFormation defaults to the CFN stack name,
+   * Helm to `{namespace}/{release}`, Terraform requires an explicit
+   * `name` attribute on the `alien_deployment` resource.
+   */
+  deploymentName: string;
+  managementConfig?: ManagementConfig | null | undefined;
+  /**
+   * Represents the target cloud platform.
+   */
+  platform: PlatformEnum;
+  /**
+   * Region or location reported by the setup artifact.
+   */
+  region: string;
+  /**
+   * Optional release id that produced the setup package. When
+   *
+   * @remarks
+   * omitted, the manager imports against the latest release.
+   */
+  releaseId?: string | null | undefined;
+  /**
+   * Stable physical-name prefix used by the setup package for generated
+   *
+   * @remarks
+   * resources. Runtime controllers use it when addressing imported
+   * resources.
+   */
+  resourcePrefix: string;
+  /**
+   * Imported resources with typed per-resource payloads.
+   */
+  resources: Array<ImportedResource>;
+  /**
+   * Setup compatibility fingerprint embedded in the package.
+   */
+  setupFingerprint: string;
+  /**
+   * Setup fingerprint algorithm version embedded in the package.
+   */
+  setupFingerprintVersion: number;
+  /**
+   * Wire-format version for the setup import payload.
+   */
+  setupImportFormatVersion: number;
+  /**
+   * Setup target this package was generated for.
+   */
+  setupTarget: string;
+  sourceKind?: ImportSourceKind | null | undefined;
+  /**
+   * User-customizable deployment settings specified at deploy time.
+   *
+   * @remarks
+   *
+   * These settings are provided by the customer via CloudFormation parameters,
+   * Terraform attributes, CLI flags, or Helm values. They customize how the
+   * deployment runs and what capabilities are enabled.
+   *
+   * **Key distinction**: StackSettings is user-customizable, while ManagementConfig
+   * is platform-derived (from the Manager's ServiceAccount).
+   */
+  stackSettings: StackSettings;
+};
+
+/** @internal */
+export type StackImportRequest$Outbound = {
+  basePlatform?: string | null | undefined;
+  deploymentGroupToken: string;
+  deploymentName: string;
+  managementConfig?: ManagementConfig$Outbound | null | undefined;
+  platform: string;
+  region: string;
+  releaseId?: string | null | undefined;
+  resourcePrefix: string;
+  resources: Array<ImportedResource$Outbound>;
+  setupFingerprint: string;
+  setupFingerprintVersion: number;
+  setupImportFormatVersion: number;
+  setupTarget: string;
+  sourceKind?: string | null | undefined;
+  stackSettings: StackSettings$Outbound;
+};
+
+/** @internal */
+export const StackImportRequest$outboundSchema: z.ZodType<
+  StackImportRequest$Outbound,
+  StackImportRequest
+> = z.object({
+  basePlatform: z.nullable(PlatformEnum$outboundSchema).optional(),
+  deploymentGroupToken: z.string(),
+  deploymentName: z.string(),
+  managementConfig: z.nullable(ManagementConfig$outboundSchema).optional(),
+  platform: PlatformEnum$outboundSchema,
+  region: z.string(),
+  releaseId: z.nullable(z.string()).optional(),
+  resourcePrefix: z.string(),
+  resources: z.array(ImportedResource$outboundSchema),
+  setupFingerprint: z.string(),
+  setupFingerprintVersion: z.int(),
+  setupImportFormatVersion: z.int(),
+  setupTarget: z.string(),
+  sourceKind: z.nullable(ImportSourceKind$outboundSchema).optional(),
+  stackSettings: StackSettings$outboundSchema,
+});
+
+export function stackImportRequestToJSON(
+  stackImportRequest: StackImportRequest,
+): string {
+  return JSON.stringify(
+    StackImportRequest$outboundSchema.parse(stackImportRequest),
+  );
+}

package/src/models/stackimportresponse.ts

@@ -0,0 +1,62 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import { StackSettings, StackSettings$inboundSchema } from "./stacksettings.js";
+import { StackState, StackState$inboundSchema } from "./stackstate.js";
+
+/**
+ * Response body returned after a stack import.
+ */
+export type StackImportResponse = {
+  /**
+   * Deployment created.
+   */
+  deploymentId: string;
+  /**
+   * Deployment bearer token for the imported deployment, when available.
+   */
+  deploymentToken?: string | null | undefined;
+  /**
+   * User-customizable deployment settings specified at deploy time.
+   *
+   * @remarks
+   *
+   * These settings are provided by the customer via CloudFormation parameters,
+   * Terraform attributes, CLI flags, or Helm values. They customize how the
+   * deployment runs and what capabilities are enabled.
+   *
+   * **Key distinction**: StackSettings is user-customizable, while ManagementConfig
+   * is platform-derived (from the Manager's ServiceAccount).
+   */
+  stackSettings: StackSettings;
+  /**
+   * Represents the collective state of all resources in a stack, including platform and pending actions.
+   */
+  stackState: StackState;
+};
+
+/** @internal */
+export const StackImportResponse$inboundSchema: z.ZodType<
+  StackImportResponse,
+  unknown
+> = z.object({
+  deploymentId: z.string(),
+  deploymentToken: z.nullable(z.string()).optional(),
+  stackSettings: StackSettings$inboundSchema,
+  stackState: StackState$inboundSchema,
+});
+
+export function stackImportResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<StackImportResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StackImportResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StackImportResponse' from JSON`,
+  );
+}

package/src/models/stackresourcestate.ts

@@ -0,0 +1,118 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { AlienError, AlienError$inboundSchema } from "./alienerror.js";
+import { BaseResource, BaseResource$inboundSchema } from "./baseresource.js";
+import {
+  BaseResourceOutputs,
+  BaseResourceOutputs$inboundSchema,
+} from "./baseresourceoutputs.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import { PlatformEnum, PlatformEnum$inboundSchema } from "./platformenum.js";
+import {
+  ResourceLifecycle,
+  ResourceLifecycle$inboundSchema,
+} from "./resourcelifecycle.js";
+import { ResourceRef, ResourceRef$inboundSchema } from "./resourceref.js";
+import {
+  ResourceStatus,
+  ResourceStatus$inboundSchema,
+} from "./resourcestatus.js";
+
+/**
+ * Represents the state of a single resource within the stack for a specific platform.
+ */
+export type StackResourceState = {
+  /**
+   * The platform-specific resource controller that manages this resource's lifecycle.
+   *
+   * @remarks
+   * This is None when the resource status is Pending.
+   * Stored as JSON to make the struct serializable and movable to alien-core.
+   */
+  internal?: any | undefined;
+  /**
+   * Resource that can hold any resource type in the Alien system. All resources share common 'type' and 'id' fields with additional type-specific properties.
+   */
+  config: BaseResource;
+  controllerPlatform?: PlatformEnum | null | undefined;
+  /**
+   * Complete list of dependencies for this resource, including infrastructure dependencies.
+   *
+   * @remarks
+   * This preserves the full dependency information from the stack definition.
+   */
+  dependencies?: Array<ResourceRef> | undefined;
+  error?: AlienError | null | undefined;
+  /**
+   * Stores the controller state that failed, used for manual retry operations.
+   *
+   * @remarks
+   * This allows resuming from the exact point where the failure occurred.
+   * Stored as JSON to make the struct serializable and movable to alien-core.
+   */
+  lastFailedState?: any | undefined;
+  lifecycle?: ResourceLifecycle | null | undefined;
+  outputs?: BaseResourceOutputs | null | undefined;
+  previousConfig?: BaseResource | null | undefined;
+  /**
+   * Binding parameters for remote access.
+   *
+   * @remarks
+   * Only populated when the resource has `remote_access: true` in its ResourceEntry.
+   * This is the JSON serialization of the binding configuration (e.g., StorageBinding, VaultBinding).
+   * Populated by controllers during provisioning using get_binding_params().
+   */
+  remoteBindingParams?: any | undefined;
+  /**
+   * Tracks consecutive retry attempts for the current state transition.
+   */
+  retryAttempt?: number | undefined;
+  /**
+   * Represents the high-level status of a resource during its lifecycle.
+   */
+  status: ResourceStatus;
+  /**
+   * The high-level type of the resource (e.g., Worker::RESOURCE_TYPE, Storage::RESOURCE_TYPE).
+   */
+  type: string;
+};
+
+/** @internal */
+export const StackResourceState$inboundSchema: z.ZodType<
+  StackResourceState,
+  unknown
+> = z.object({
+  _internal: z.any().optional(),
+  config: BaseResource$inboundSchema,
+  controllerPlatform: z.nullable(PlatformEnum$inboundSchema).optional(),
+  dependencies: z.array(ResourceRef$inboundSchema).optional(),
+  error: z.nullable(AlienError$inboundSchema).optional(),
+  lastFailedState: z.any().optional(),
+  lifecycle: z.nullable(ResourceLifecycle$inboundSchema).optional(),
+  outputs: z.nullable(BaseResourceOutputs$inboundSchema).optional(),
+  previousConfig: z.nullable(BaseResource$inboundSchema).optional(),
+  remoteBindingParams: z.any().optional(),
+  retryAttempt: z.int().optional(),
+  status: ResourceStatus$inboundSchema,
+  type: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "_internal": "internal",
+  });
+});
+
+export function stackResourceStateFromJSON(
+  jsonString: string,
+): SafeParseResult<StackResourceState, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StackResourceState$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StackResourceState' from JSON`,
+  );
+}

package/src/models/stacksettings.ts

@@ -3,29 +3,47 @@
  */
 
 import * as z from "zod/v4";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
 import {
   DeploymentModel,
+  DeploymentModel$inboundSchema,
   DeploymentModel$outboundSchema,
 } from "./deploymentmodel.js";
 import {
   DomainSettings,
+  DomainSettings$inboundSchema,
   DomainSettings$Outbound,
   DomainSettings$outboundSchema,
 } from "./domainsettings.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
 import {
   HeartbeatsMode,
+  HeartbeatsMode$inboundSchema,
   HeartbeatsMode$outboundSchema,
 } from "./heartbeatsmode.js";
+import {
+  KubernetesSettings,
+  KubernetesSettings$inboundSchema,
+  KubernetesSettings$Outbound,
+  KubernetesSettings$outboundSchema,
+} from "./kubernetessettings.js";
 import {
   NetworkSettings,
+  NetworkSettings$inboundSchema,
   NetworkSettings$Outbound,
   NetworkSettings$outboundSchema,
 } from "./networksettings.js";
 import {
   TelemetryMode,
+  TelemetryMode$inboundSchema,
   TelemetryMode$outboundSchema,
 } from "./telemetrymode.js";
-import { UpdatesMode, UpdatesMode$outboundSchema } from "./updatesmode.js";
+import {
+  UpdatesMode,
+  UpdatesMode$inboundSchema,
+  UpdatesMode$outboundSchema,
+} from "./updatesmode.js";
 
 /**
  * External bindings for pre-existing infrastructure.
@@ -68,6 +86,7 @@ export type StackSettings = {
    * How heartbeat health checks are handled.
    */
   heartbeats?: HeartbeatsMode | undefined;
+  kubernetes?: KubernetesSettings | null | undefined;
   network?: NetworkSettings | null | undefined;
   /**
    * How telemetry (logs, metrics, traces) is handled.
@@ -79,6 +98,11 @@ export type StackSettings = {
   updates?: UpdatesMode | undefined;
 };
 
+/** @internal */
+export const ExternalBindings$inboundSchema: z.ZodType<
+  ExternalBindings,
+  unknown
+> = z.object({});
 /** @internal */
 export type ExternalBindings$Outbound = {};
 
@@ -95,13 +119,36 @@ export function externalBindingsToJSON(
     ExternalBindings$outboundSchema.parse(externalBindings),
   );
 }
+export function externalBindingsFromJSON(
+  jsonString: string,
+): SafeParseResult<ExternalBindings, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ExternalBindings$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ExternalBindings' from JSON`,
+  );
+}
 
+/** @internal */
+export const StackSettings$inboundSchema: z.ZodType<StackSettings, unknown> = z
+  .object({
+    deploymentModel: DeploymentModel$inboundSchema.optional(),
+    domains: z.nullable(DomainSettings$inboundSchema).optional(),
+    externalBindings: z.nullable(z.lazy(() => ExternalBindings$inboundSchema))
+      .optional(),
+    heartbeats: HeartbeatsMode$inboundSchema.optional(),
+    kubernetes: z.nullable(KubernetesSettings$inboundSchema).optional(),
+    network: z.nullable(NetworkSettings$inboundSchema).optional(),
+    telemetry: TelemetryMode$inboundSchema.optional(),
+    updates: UpdatesMode$inboundSchema.optional(),
+  });
 /** @internal */
 export type StackSettings$Outbound = {
   deploymentModel?: string | undefined;
   domains?: DomainSettings$Outbound | null | undefined;
   externalBindings?: ExternalBindings$Outbound | null | undefined;
   heartbeats?: string | undefined;
+  kubernetes?: KubernetesSettings$Outbound | null | undefined;
   network?: NetworkSettings$Outbound | null | undefined;
   telemetry?: string | undefined;
   updates?: string | undefined;
@@ -117,6 +164,7 @@ export const StackSettings$outboundSchema: z.ZodType<
   externalBindings: z.nullable(z.lazy(() => ExternalBindings$outboundSchema))
     .optional(),
   heartbeats: HeartbeatsMode$outboundSchema.optional(),
+  kubernetes: z.nullable(KubernetesSettings$outboundSchema).optional(),
   network: z.nullable(NetworkSettings$outboundSchema).optional(),
   telemetry: TelemetryMode$outboundSchema.optional(),
   updates: UpdatesMode$outboundSchema.optional(),
@@ -125,3 +173,12 @@ export const StackSettings$outboundSchema: z.ZodType<
 export function stackSettingsToJSON(stackSettings: StackSettings): string {
   return JSON.stringify(StackSettings$outboundSchema.parse(stackSettings));
 }
+export function stackSettingsFromJSON(
+  jsonString: string,
+): SafeParseResult<StackSettings, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StackSettings$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StackSettings' from JSON`,
+  );
+}

package/src/models/stackstate.ts

@@ -0,0 +1,49 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import { PlatformEnum, PlatformEnum$inboundSchema } from "./platformenum.js";
+import {
+  StackResourceState,
+  StackResourceState$inboundSchema,
+} from "./stackresourcestate.js";
+
+/**
+ * Represents the collective state of all resources in a stack, including platform and pending actions.
+ */
+export type StackState = {
+  /**
+   * Represents the target cloud platform.
+   */
+  platform: PlatformEnum;
+  /**
+   * A prefix used for resource naming to ensure uniqueness across deployments.
+   */
+  resourcePrefix: string;
+  /**
+   * The state of individual resources, keyed by resource ID.
+   */
+  resources: { [k: string]: StackResourceState };
+};
+
+/** @internal */
+export const StackState$inboundSchema: z.ZodType<StackState, unknown> = z
+  .object({
+    platform: PlatformEnum$inboundSchema,
+    resourcePrefix: z.string(),
+    resources: z.record(z.string(), StackResourceState$inboundSchema),
+  });
+
+export function stackStateFromJSON(
+  jsonString: string,
+): SafeParseResult<StackState, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StackState$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StackState' from JSON`,
+  );
+}