Skip to main content

Package

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

type Package {
  id: ID!
  namePrefix: String! @deprecated
  slug: 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!
  operatorGuide: Markdown
  environment: Environment!
  deployments: [Deployment]
  connections: [Connection]
  artifacts: [Artifact]
  propertySummaries: [ArtifactPropertySummary]
  remoteReferences: [RemoteReference]
  cost: Cost!
}

Fields​

Package.id ● ID! non-null scalar​

Unique identifier

Package.slug ● String! non-null scalar​

Unique identifier for the package

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.

Package.alarms ● [Alarm] list object​

Cloud alarms configured through IaC for this package

Package.secretFields ● [SecretField] list object​

Secret configuration for application packages

Package.activeDeployment ● Deployment object​

Currently active deployment for this package

Package.decommissionable ● PackageDeletionLifecycle! non-null object​

Checks if this package can be decommissioned.

Package.manifest ● Manifest! non-null object​

Package.paramsSchema ● JSON! non-null scalar​

Package.operatorGuide ● Markdown scalar​

The operator guide for the bundle with params rendered via templating if enabled

Package.environment ● Environment! non-null object​

The environment this package will be deployed to

Package.deployments ● [Deployment] list object​

Package.connections ● [Connection] list object​

Package.artifacts ● [Artifact] list object​

Artifacts provisioned by this package

Package.propertySummaries ● [ArtifactPropertySummary] list object​

Flattened list of artifact payload property summaries suitable for display in a table. Sensitive fields are automatically masked.

Package.remoteReferences ● [RemoteReference] list object​

Artifacts from a remote source like another project or a resource not managed by massdriver

Package.cost ● Cost! non-null object​

Cloud provider costs for this package

Show deprecated

Returned By​

getPackageByNamingConvention query ● package query

Member Of​

Artifact object ● Connection object ● Deployment object ● Environment object ● EnvironmentDeletionLifecyclePackageError object ● Manifest object ● ManifestDeletionLifecyclePackageError object ● PackageCreated object ● PackageDeleted object ● PackagePayload object ● PackageUpdated object ● ProjectDeletionLifecyclePackageError object ● RemoteReference object