Migrating

Read this page before bumping terradart_google across minor lines or when a release note calls out breaking API changes.

The canonical, full migration history lives in the repo: MIGRATING.md on GitHub.

0.27.0 → 0.28.0 (TfArg.expression, provider aliases)

0.28.0 ships the terradart-migrate epic and two terradart_core changes that are additive for code that only constructs arguments and registers the shipped providers, but break an exhaustive match and a hand-written provider:

• TfArg gains a fourth variant, TfArgExpression (TfArg.expression(...) — a raw Terraform expression, emitted verbatim). An exhaustive switch over TfArg needs one more case.
• StackProvider gains String? get alias. Every provider class in the workspace implements it; a hand-written StackProvider needs the getter (null for the default configuration).

Bump lockstep:

dependencies:
  terradart_core: ^0.28.0
  terradart_google: ^0.28.0

// Before
switch (arg) {
  case TfArgLiteral(:final value): ...
  case TfArgRef(:final ref): ...
  case TfArgVariable(:final name): ...
}

// After
switch (arg) {
  case TfArgLiteral(:final value): ...
  case TfArgRef(:final ref): ...
  case TfArgVariable(:final name): ...
  case TfArgExpression(:final template): ...
}

Everything else in 0.28.0 is additive — provider: and timeouts: on every curated factory, Stack.addMoved, Stack.addModule, TfArg.workspace(), partial GcsBackend / S3Backend configuration. Full notes: MIGRATING.md — 0.27.0 → 0.28.0.

---

0.12.11 → 0.12.12 (sealed exactly-one slots)

0.12.12 enforces GCP exactly_one_of groups at compile time on seven existing factories. Optional per-block params (allow / deny, httpsHealthCheck, query, filename, …) become a single required sealed virtual slot (rulePolicy, protocol, jobConfiguration, buildSpec, …).

Bump lockstep:

dependencies:
  terradart_core: ^0.12.12
  terradart_google: ^0.12.12

Factory	Before	After
GoogleComputeFirewall	allow: / deny:	rulePolicy:
GoogleComputeHealthCheck	httpsHealthCheck: / …	protocol:
GoogleComputeRegionHealthCheck	per-protocol optional blocks	protocol:
GoogleMonitoringUptimeCheckConfig	monitoredResource: / …	target:
GoogleBigqueryJob	query: / load: / …	jobConfiguration:
GoogleBigqueryConnection	cloudSql: / aws: / …	backend:
GoogleCloudbuildTrigger	filename: / build: / …	buildSpec:

Full tables and before/after examples: MIGRATING.md — 0.12.11 → 0.12.12.

---

0.12.9 → 0.12.10 (typed enums)

Read this section before bumping terradart_google from 0.12.9 to 0.12.10 (or any ^0.12.10 caret that resolves to 0.12.10+). Patch releases within 0.12.10 are additive only; the breaking surface below landed in 0.12.10.

Lockstep bumps

Bump all workspace packages together:

dependencies:
  terradart_core: ^0.12.10
  terradart_google: ^0.12.10

Check pub.dev for the latest 0.12.x patch.

What changed in 0.12.10

terradart_google now uses typed enums and nested helper classes wherever the Terraform provider schema exposes a finite set of string values or a structured nested block. Fields that used to accept TfArg<String> or TfArg<Map<String, dynamic>>? may now require enum constants or helper encode() types.

dart analyze surfaces most mismatches immediately — string literals that compiled on 0.12.9 no longer type-check.

Top-level enum fields

Factory	Field	Enum
GoogleBigqueryDatapolicyDataPolicy	dataPolicyType	BigqueryDatapolicyDataPolicyType
GoogleBigqueryReservationAssignment	jobType	BigqueryReservationAssignmentJobType
GoogleComputeServiceAttachment	connectionPreference	ServiceAttachmentConnectionPreference
GoogleComputeRegionSecurityPolicy	type	RegionSecurityPolicyType
GoogleComputeRegionSslPolicy	profile / minTlsVersion	RegionSslPolicyProfile / RegionSslPolicyMinTlsVersion
GoogleComputeTargetTcpProxy	proxyHeader	TargetTcpProxyProxyHeader
GoogleComputeTargetSslProxy	proxyHeader	TargetSslProxyProxyHeader
GoogleComputeRegionTargetTcpProxy	proxyHeader	RegionTargetTcpProxyProxyHeader
GoogleCloudTasksQueue	desiredState	CloudTasksQueueDesiredState
GoogleLoggingSavedQuery	visibility	LoggingSavedQueryVisibility
GoogleMonitoringSlo	calendarPeriod	MonitoringSloCalendarPeriod
GoogleStorageHmacKey	state	StorageHmacKeyState
GoogleKmsCryptoKeyVersion	state	KmsCryptoKeyVersionState
GoogleSecretManagerSecretVersion	deletionPolicy	SecretManagerSecretVersionDeletionPolicy
GoogleComputeInstanceGroupManager	listManagedInstancesResults	InstanceGroupManagerListManagedInstancesResults
GoogleComputeRegionInstanceGroupManager	listManagedInstancesResults	RegionInstanceGroupManagerListManagedInstancesResults
GoogleSqlUser	deletionPolicy	SqlUserDeletionPolicy

Optional Analytics Hub discoveryType fields use BigqueryAnalyticsHubDataExchangeDiscoveryType / BigqueryAnalyticsHubListingDiscoveryType.

Factories introduced in 0.12.10 (for example GoogleDnsRecordSet.type, GoogleCloudRunV2WorkerPool.launchStage) ship as enums from day one — there is no prior String API to migrate.

Nested helper blocks

Factory	Slot	Helper / enum
GoogleComputeRouter	bgp	ComputeRouterBgp / ComputeRouterBgpAdvertiseMode
GoogleComputeSecurityPolicyRule	match / rateLimitOptions	ComputeSecurityPolicyRule* types
GoogleComputeRegionSecurityPolicyRule	match / rateLimitOptions	ComputeRegionSecurityPolicyRule* types
GoogleEventarcMessageBus / GoogleEventarcGoogleApiSource / GoogleEventarcPipeline	loggingConfig	EventarcMessageBusLoggingConfig / EventarcMessageBusLogSeverity
GoogleComputeInstance / GoogleComputeInstanceTemplate	networkPerformanceConfig	ComputeInstanceNetworkPerformanceConfigTotalEgressBandwidthTier
GoogleComputeBackendService	localityLbPolicies	LocalityLbPolicy
GoogleComputeRegionSecurityPolicy	rules / advancedOptionsConfig / …	ComputeRegionSecurityPolicy* helpers
GoogleComputeUrlMap / GoogleComputeRegionUrlMap	route actions / cache policy	*UrlMapRouteAction / *UrlMapCacheMode
GoogleDnsPolicy	alternativeNameServerConfig	DnsPolicyAlternativeNameServerConfig
GoogleDnsRecordSet	routingPolicy	DnsRecordSetRoutingPolicy*
GoogleDnsResponsePolicyRule	localData	DnsResponsePolicyRuleLocalData
GooglePubsubTopic	schemaSettings / ingestionDataSourceSettings	PubsubTopic* helpers
GoogleGkeHubFleet	defaultClusterConfig	GkeHubFleetDefaultClusterConfig
GoogleGkeBackupBackupPlan / GoogleGkeBackupRestorePlan	schedule / restore config	GkeBackup* helpers
GoogleCloudRunV2WorkerPool	template / scaling	CloudRunV2WorkerPool* helpers
GoogleBigqueryDatapolicyDataPolicy	dataMaskingPolicy	BigqueryDatapolicyDataPolicyDataMaskingPolicy
GoogleArtifactRegistryRepository	remote APT/YUM bases	ArtifactRegistryAptRepositoryBase / ArtifactRegistryYumRepositoryBase

Before and after

0.12.9

dataPolicyType: TfArg.literal('DATA_MASKING_POLICY'),
connectionPreference: TfArg.literal('ACCEPT_AUTOMATIC'),

// 0.12.10
dataPolicyType: TfArg.literal(BigqueryDatapolicyDataPolicyType.dataMaskingPolicy),
connectionPreference:
    TfArg.literal(ServiceAttachmentConnectionPreference.acceptAutomatic),

For nested blocks, replace raw maps with helper constructors and call .encode() only when you hand-roll arg maps — curated factories accept the helper types directly on constructor parameters.

GoogleComputeRegionSecurityPolicy rules

GoogleComputeRegionSecurityPolicy now expects embedded rules on the policy resource. Standalone GoogleComputeRegionSecurityPolicyRule remains for additional rules added after the policy exists.

Additive factories (no migration)

Waves 23–24 shipped ten new curated factories in 0.12.10. They are additive — only adopt them when you need the capability. See Coverage for the current factory list and runnable examples.

Older releases

Earlier breaking changes (WIF provider sealed trustSource, terradart codegen removal, Stack class modifiers, and more) are documented in MIGRATING.md.

Next steps

• Coverage — the current factory list and example stacks
• Status & versioning — alpha expectations and change policy
• Examples — updated quickstarts exercising the new APIs