Bundle

A versioned infrastructure-as-code package.

A bundle is a single published version of an IaC package in your organization's catalog. Each bundle belongs to an OCI repository and is identified by a composite name@version string (e.g., aws-aurora-postgres@1.2.3).

Bundles declare dependencies (inputs they require from other bundles) and resources (outputs they produce). These declarations drive the connection system on the Massdriver canvas -- when you add a component to a blueprint, the platform knows which other components can satisfy its dependencies.

type Bundle {
  id: BundleId!
  name: OciRepoName!
  version: Semver!
  description: String
  icon: String
  sourceUrl: String
  readme: String
  changelog: String
  createdAt: DateTime!
  updatedAt: DateTime!
  effectiveAttributes: Map!
  repo: String!
  dependencies: [BundleDependency!]!
  resources: [BundleResource!]!
}

Fields

Bundle.id ● BundleId! non-null scalar {#id}

Composite identifier in name@version format (e.g., aws-aurora-postgres@1.2.3). Always contains the fully resolved semver version.

Bundle.name ● OciRepoName! non-null scalar {#name}

OCI repository name this bundle belongs to (e.g., aws-aurora-postgres).

Bundle.version ● Semver! non-null scalar {#version}

Fully resolved semantic version of this bundle (e.g., 1.2.3).

Bundle.description ● String scalar {#description}

Short summary of what this bundle provisions.

Bundle.icon ● String scalar {#icon}

URL to the bundle's display icon.

Bundle.sourceUrl ● String scalar {#source-url}

URL to the bundle's source code repository, if published by the author.

Bundle.readme ● String scalar {#readme}

The README for this exact bundle version, in markdown. null if the publisher didn't include one.

Use this when rendering documentation for a specific version — for the latest stable README at the repository level, use OciRepo.readme.

Bundle.changelog ● String scalar {#changelog}

The changelog for this exact bundle version, in markdown. null if the publisher didn't include one.

Each version's changelog is preserved — for the latest stable changelog at the repository level, use OciRepo.changelog.

Bundle.createdAt ● DateTime! non-null scalar {#created-at}

Timestamp when this bundle version was first published (UTC).

Bundle.updatedAt ● DateTime! non-null scalar {#updated-at}

Timestamp when this bundle version was last modified (UTC).

Bundle.effectiveAttributes ● Map! non-null scalar {#effective-attributes}

The full set of attributes that ABAC policy evaluation sees for this bundle version — the auto-injected md-* system attributes (today: md-id, md-repo, md-bundle). Bundle versions are immutable snapshots and do not carry user attributes of their own.

Bundle.repo ● String! non-null scalar {#repo}

OCI repository name for this bundle (e.g., aws-aurora-postgres). Equivalent to name.

Bundle.dependencies ● [BundleDependency!]! non-null object {#dependencies}

Dependencies (inputs) this bundle requires. Each entry names a slot and the resource type it accepts. Sorted alphabetically by name.

Bundle.resources ● [BundleResource!]! non-null object {#resources}

Resources (outputs) this bundle produces when deployed. Each entry names a slot and the resource type it creates. Sorted alphabetically by name.

Returned By

bundle query

Member Of

BundleEvent object ● Instance object