feat: Add standby compression start delay

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 52
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fhypeman-52bc64e89c8406b774158cdb7fdb239dd4c39e6bace06b32e5224b82462f9ffe.yml
-openapi_spec_hash: 647ddb91aa6aca7034f2015071c30ce6
-config_hash: d81afc6f4fabf65fc9291db9ddd79f87
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fhypeman-c6da5deb317c83b7a10434593eb22ec7cb27009aba0b92efaefbbe21884054ad.yml
+openapi_spec_hash: ff73a0e1f7a8bd5a5d1ae38d994bb9cd
+config_hash: ed668fae8826ff533f38df16c9664f44

api.md

@@ -37,6 +37,7 @@ Params Types:
 - <a href="https://pkg.go.dev/github.com/kernel/hypeman-go">hypeman</a>.<a href="https://pkg.go.dev/github.com/kernel/hypeman-go#SetSnapshotScheduleRequestParam">SetSnapshotScheduleRequestParam</a>
 - <a href="https://pkg.go.dev/github.com/kernel/hypeman-go">hypeman</a>.<a href="https://pkg.go.dev/github.com/kernel/hypeman-go#SnapshotPolicyParam">SnapshotPolicyParam</a>
 - <a href="https://pkg.go.dev/github.com/kernel/hypeman-go">hypeman</a>.<a href="https://pkg.go.dev/github.com/kernel/hypeman-go#SnapshotScheduleRetentionParam">SnapshotScheduleRetentionParam</a>
+- <a href="https://pkg.go.dev/github.com/kernel/hypeman-go">hypeman</a>.<a href="https://pkg.go.dev/github.com/kernel/hypeman-go#StandbyInstanceRequestParam">StandbyInstanceRequestParam</a>
 - <a href="https://pkg.go.dev/github.com/kernel/hypeman-go">hypeman</a>.<a href="https://pkg.go.dev/github.com/kernel/hypeman-go#VolumeMountParam">VolumeMountParam</a>
 
 Response Types:

instance.go

@@ -14,6 +14,7 @@ import (
 
 	"github.com/kernel/hypeman-go/internal/apijson"
 	"github.com/kernel/hypeman-go/internal/apiquery"
+	shimjson "github.com/kernel/hypeman-go/internal/encoding/json"
 	"github.com/kernel/hypeman-go/internal/requestconfig"
 	"github.com/kernel/hypeman-go/option"
 	"github.com/kernel/hypeman-go/packages/param"
@@ -675,11 +676,16 @@ func (r *SetSnapshotScheduleRequestParam) UnmarshalJSON(data []byte) error {
 
 type SnapshotPolicy struct {
 	Compression shared.SnapshotCompressionConfig `json:"compression"`
+	// Delay before standby snapshot compression begins, expressed as a Go duration
+	// like "30s" or "5m". Applies only to standby compression and defaults to
+	// immediate start when omitted.
+	StandbyCompressionDelay string `json:"standby_compression_delay"`
 	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
 	JSON struct {
-		Compression respjson.Field
-		ExtraFields map[string]respjson.Field
-		raw         string
+		Compression             respjson.Field
+		StandbyCompressionDelay respjson.Field
+		ExtraFields             map[string]respjson.Field
+		raw                     string
 	} `json:"-"`
 }
 
@@ -699,7 +705,11 @@ func (r SnapshotPolicy) ToParam() SnapshotPolicyParam {
 }
 
 type SnapshotPolicyParam struct {
-	Compression shared.SnapshotCompressionConfigParam `json:"compression,omitzero"`
+	// Delay before standby snapshot compression begins, expressed as a Go duration
+	// like "30s" or "5m". Applies only to standby compression and defaults to
+	// immediate start when omitted.
+	StandbyCompressionDelay param.Opt[string]                     `json:"standby_compression_delay,omitzero"`
+	Compression             shared.SnapshotCompressionConfigParam `json:"compression,omitzero"`
 	paramObj
 }
 
@@ -808,6 +818,24 @@ func (r *SnapshotScheduleRetentionParam) UnmarshalJSON(data []byte) error {
 	return apijson.UnmarshalRoot(data, r)
 }
 
+type StandbyInstanceRequestParam struct {
+	// Delay before standby snapshot compression begins, expressed as a Go duration
+	// like "30s" or "5m". Overrides the instance default for this standby operation
+	// only.
+	CompressionDelay param.Opt[string] `json:"compression_delay,omitzero"`
+	// Compression settings for standby snapshot memory. Overrides instance defaults.
+	Compression shared.SnapshotCompressionConfigParam `json:"compression,omitzero"`
+	paramObj
+}
+
+func (r StandbyInstanceRequestParam) MarshalJSON() (data []byte, err error) {
+	type shadow StandbyInstanceRequestParam
+	return param.MarshalObject(r, (*shadow)(&r))
+}
+func (r *StandbyInstanceRequestParam) UnmarshalJSON(data []byte) error {
+	return apijson.UnmarshalRoot(data, r)
+}
+
 type VolumeMount struct {
 	// Path where volume is mounted in the guest
 	MountPath string `json:"mount_path" api:"required"`
@@ -964,8 +992,9 @@ type InstanceNewParams struct {
 	Hypervisor InstanceNewParamsHypervisor `json:"hypervisor,omitzero"`
 	// Network configuration for the instance
 	Network InstanceNewParamsNetwork `json:"network,omitzero"`
-	// Snapshot compression policy for this instance. Controls compression settings
-	// applied when creating snapshots or entering standby.
+	// Snapshot policy for this instance. Controls compression settings applied when
+	// creating snapshots or entering standby, plus any default standby-only
+	// compression delay.
 	SnapshotPolicy SnapshotPolicyParam `json:"snapshot_policy,omitzero"`
 	// User-defined key-value tags.
 	Tags map[string]string `json:"tags,omitzero"`
@@ -1275,13 +1304,12 @@ const (
 )
 
 type InstanceStandbyParams struct {
-	Compression shared.SnapshotCompressionConfigParam `json:"compression,omitzero"`
+	StandbyInstanceRequest StandbyInstanceRequestParam
 	paramObj
 }
 
 func (r InstanceStandbyParams) MarshalJSON() (data []byte, err error) {
-	type shadow InstanceStandbyParams
-	return param.MarshalObject(r, (*shadow)(&r))
+	return shimjson.Marshal(r.StandbyInstanceRequest)
 }
 func (r *InstanceStandbyParams) UnmarshalJSON(data []byte) error {
 	return apijson.UnmarshalRoot(data, r)

instance_test.go

@@ -84,6 +84,7 @@ func TestInstanceNewWithOptionalParams(t *testing.T) {
 				Algorithm: shared.SnapshotCompressionConfigAlgorithmZstd,
 				Level:     hypeman.Int(1),
 			},
+			StandbyCompressionDelay: hypeman.String("2m"),
 		},
 		Tags: map[string]string{
 			"team": "backend",
@@ -290,10 +291,13 @@ func TestInstanceStandbyWithOptionalParams(t *testing.T) {
 		context.TODO(),
 		"id",
 		hypeman.InstanceStandbyParams{
-			Compression: shared.SnapshotCompressionConfigParam{
-				Enabled:   true,
-				Algorithm: shared.SnapshotCompressionConfigAlgorithmZstd,
-				Level:     hypeman.Int(1),
+			StandbyInstanceRequest: hypeman.StandbyInstanceRequestParam{
+				Compression: shared.SnapshotCompressionConfigParam{
+					Enabled:   true,
+					Algorithm: shared.SnapshotCompressionConfigAlgorithmZstd,
+					Level:     hypeman.Int(1),
+				},
+				CompressionDelay: hypeman.String("45s"),
 			},
 		},
 	)