statestore: Add experimental notes + changelog (#1277)

Author: austinvalle

.changes/unreleased/ENHANCEMENTS-20260216-151551.yaml

@@ -0,0 +1,5 @@
+kind: ENHANCEMENTS
+body: 'provider: Added `ProviderWithStateStores` interface for implementing state stores'
+time: 2026-02-16T15:15:51.783658-05:00
+custom:
+    Issue: "1259"

.changes/unreleased/ENHANCEMENTS-20260216-151646.yaml

@@ -0,0 +1,5 @@
+kind: ENHANCEMENTS
+body: 'provider: Added `StateStoreData` to `ConfigureResponse`, to pass provider-defined data to `(statestore.StateStore).Initialize` methods'
+time: 2026-02-16T15:16:46.375269-05:00
+custom:
+    Issue: "1262"

.changes/unreleased/FEATURES-20260216-150444.yaml

@@ -0,0 +1,5 @@
+kind: FEATURES
+body: 'statestore: New package for implementing state stores'
+time: 2026-02-16T15:04:44.812342-05:00
+custom:
+    Issue: "1259"

.changes/unreleased/FEATURES-20260216-151518.yaml

@@ -0,0 +1,5 @@
+kind: FEATURES
+body: 'statestore/schema: New package for implementing state store schemas'
+time: 2026-02-16T15:15:18.148949-05:00
+custom:
+    Issue: "1259"

.changes/unreleased/NOTES-20260216-150451.yaml

@@ -0,0 +1,6 @@
+kind: NOTES
+body: 'State store support is considered experimental and offered without compatibility
+    promises until support for `state_store` in Terraform core is generally available.'
+time: 2026-02-16T15:04:51.956532-05:00
+custom:
+    Issue: "1259"

provider/provider.go

@@ -167,7 +167,9 @@ type ProviderWithValidateConfig interface {
 }
 
 // ProviderWithStateStores is an interface type that extends Provider to include state stores.
-// TODO: Add supported Terraform version note
+//
+// NOTE: State store support is experimental and exposed without compatibility promises until
+// these notices are removed.
 type ProviderWithStateStores interface {
 	Provider
 

statestore/schema/doc.go

@@ -4,4 +4,7 @@
 // Package schema contains all available schema functionality for state stores.
 // State store schemas define the structure and value types for configuration data.
 // Schemas are implemented via the statestore.StateStore type Schema method.
+//
+// NOTE: State store support is experimental and exposed without compatibility promises until
+// these notices are removed.
 package schema

statestore/statestore.go

@@ -7,6 +7,8 @@ import (
 	"context"
 )
 
+// NOTE: State store support is experimental and exposed without compatibility promises until
+// these notices are removed.
 type StateStore interface {
 	// Metadata should return the full name of the state store, such
 	// as examplecloud_store.