Package

A deployed instance of a bundle in the context of its manifest

type Package {
  id: ID!
  namePrefix: String!
  params: JSON!
  status: PackageStatus!
  createdAt: DateTime!
  updatedAt: DateTime!
  bundle: Bundle!
  version: VersionConstraint!
  resolvedVersion: String!
  releaseStrategy: ReleaseStrategy!
  deployedVersion: String
  latestDeployment: Deployment
  availableUpgrade: String
  alarms: [Alarm]
  secretFields: [SecretField]
  activeDeployment: Deployment
  decommissionable: PackageDeletionLifecycle!
  manifest: Manifest!
  paramsSchema: JSON!
  environment: Environment!
  deployments: [Deployment]
  connections: [Connection]
  artifacts: [Artifact]
  remoteReferences: [RemoteReference]
  cost: Cost
}

Fields

`Package.id` ● `ID!` non-null scalar

Unique identifier

`Package.namePrefix` ● `String!` non-null scalar

Prefix for resource names

`Package.params` ● `JSON!` non-null scalar

Package configuration parameters

`Package.status` ● `PackageStatus!` non-null enum

Current status of the package

`Package.createdAt` ● `DateTime!` non-null scalar

When the package was created

`Package.updatedAt` ● `DateTime!` non-null scalar

When the package was last updated

`Package.bundle` ● `Bundle!` non-null object

`Package.version` ● `VersionConstraint!` non-null scalar

The version constraint for this package. This determines which bundle release version the package should use. Supports semver constraints (~1.2, ~1), exact versions (1.2.3), and release channels (latest). See VersionConstraint type documentation for supported formats and examples.

`Package.resolvedVersion` ● `String!` non-null scalar

The actual semantic version of the bundle release currently configured for this package. This is the resolved version based on the version constraint and will be used for the next deployment. Example: if version is "~1.2", resolvedVersion might be "1.2.5".

`Package.releaseStrategy` ● `ReleaseStrategy!` non-null enum

The release strategy for this package. Determines whether the package should receive stable releases only or also development releases.

`Package.deployedVersion` ● `String` scalar

The semantic version that was last executed. This reflects what has been provisioned to infrastructure, which may differ from resolvedVersion if the package hasn't been deployed since the version was changed. Returns nil if never deployed.

`Package.latestDeployment` ● `Deployment` object

The latest deployment for this package

`Package.availableUpgrade` ● `String` scalar

The newest version available for upgrade based on the package's version constraint. Returns nil if no upgrade is available or if already on the latest matching version. For strict semver constraints (1.2.3), checks for patch-level upgrades (~1.2). For release channels (~1.2, ~1, latest), checks for the newest matching version.