Bundle class

A bundle that aggregates multiple items in the Kumiho system.

Bundles are special items (kind="bundle") that can contain references to other items. They provide a way to group related assets together and maintain an audit trail of membership changes. Bundles are first-class model objects—they expose rich helper methods without requiring the consumer to touch protobuf-generated stubs.

Practical scenarios include:

• Packaging the set of approved assets for a release.
• Tracking episodic or level-based deliveries without duplicating the underlying items.
• Capturing metadata on the membership relationship (e.g., role, variant, platform) for downstream automation.

final bundle = await project.createBundle('release-v1');

// Add items to the bundle
await bundle.addMember(hero.kref);
await bundle.addMember(texture.kref);

// Get bundle members
final members = await bundle.getMembers();
for (final member in members) {
  print(member.itemKref.uri);
}

// Get membership history
final history = await bundle.getMembershipHistory();