fix(api): honour maxAgeMs=0 on brand retrieve, styleguide and fonts endpoints (#998)

Stainless-Generated-From: 4477f7a60e52a3267b213b91a9c0dca57a2fdaa1

Author: stlc-bot

pkg/cmd/brand.go

@@ -37,7 +37,7 @@ var brandRetrieve = cli.Command{
 		},
 		&requestflag.Flag[int64]{
 			Name:     "max-age-ms",
-			Usage:    "Maximum age in milliseconds for cached brand data before the API performs a hard refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms) are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1 year.",
+			Usage:    "Maximum age in milliseconds for cached brand data before the API performs a hard refresh. Defaults to 3 months (7776000000 ms). Set to 0 to always perform a hard refresh. Negative values are clamped to 0; values above 1 year (31536000000 ms) are clamped to 1 year.",
 			BodyPath: "maxAgeMs",
 		},
 		&requestflag.Flag[bool]{
@@ -128,7 +128,7 @@ var brandRetrieveSimplified = cli.Command{
 		},
 		&requestflag.Flag[*int64]{
 			Name:      "max-age-ms",
-			Usage:     "Maximum age in milliseconds for cached brand data before the API performs a hard refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms) are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1 year.",
+			Usage:     "Maximum age in milliseconds for cached brand data before the API performs a hard refresh. Defaults to 3 months (7776000000 ms). Set to 0 to always perform a hard refresh. Negative values are clamped to 0; values above 1 year (31536000000 ms) are clamped to 1 year.",
 			Default:   requestflag.Ptr[int64](7776000000),
 			QueryPath: "maxAgeMs",
 		},

pkg/cmd/web.go

@@ -180,7 +180,7 @@ var webExtractFonts = cli.Command{
 		},
 		&requestflag.Flag[*int64]{
 			Name:      "max-age-ms",
-			Usage:     "Maximum age in milliseconds for cached brand data before the API performs a hard refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms) are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1 year.",
+			Usage:     "Maximum age in milliseconds for cached brand data before the API performs a hard refresh. Defaults to 3 months (7776000000 ms). Set to 0 to always perform a hard refresh. Negative values are clamped to 0; values above 1 year (31536000000 ms) are clamped to 1 year.",
 			Default:   requestflag.Ptr[int64](7776000000),
 			QueryPath: "maxAgeMs",
 		},
@@ -221,7 +221,7 @@ var webExtractStyleguide = cli.Command{
 		},
 		&requestflag.Flag[*int64]{
 			Name:      "max-age-ms",
-			Usage:     "Maximum age in milliseconds for cached brand data before the API performs a hard refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms) are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1 year.",
+			Usage:     "Maximum age in milliseconds for cached brand data before the API performs a hard refresh. Defaults to 3 months (7776000000 ms). Set to 0 to always perform a hard refresh. Negative values are clamped to 0; values above 1 year (31536000000 ms) are clamped to 1 year.",
 			Default:   requestflag.Ptr[int64](7776000000),
 			QueryPath: "maxAgeMs",
 		},