cli: add --expiry (RFC3339/duration), support 'none' to clear

resource/create.go

@@ -25,7 +25,7 @@ func init() {
 	ResourceCreateCmd.Flags().StringP("password", "p", "", "Resource Password")
 	ResourceCreateCmd.Flags().StringP("description", "d", "", "Resource Description")
 	ResourceCreateCmd.Flags().StringP("folderParentID", "f", "", "Folder in which to create the Resource")
-
+	ResourceCreateCmd.Flags().String("expiry", "", "Expiry as RFC3339 (e.g. 2025-12-31T23:59:59Z) or duration (e.g. 7d, 12h, 30m, 1w2d)")
 	ResourceCreateCmd.MarkFlagRequired("name")
 	ResourceCreateCmd.MarkFlagRequired("password")
 }
@@ -55,6 +55,12 @@ func ResourceCreate(cmd *cobra.Command, args []string) error {
 	if err != nil {
 		return err
 	}
+
+	expiry, err := cmd.Flags().GetString("expiry")
+	if err != nil {
+		return err
+	}
+
 	jsonOutput, err := cmd.Flags().GetBool("json")
 	if err != nil {
 		return err
@@ -83,6 +89,12 @@ func ResourceCreate(cmd *cobra.Command, args []string) error {
 		return fmt.Errorf("Creating Resource: %w", err)
 	}
 
+	if expiry != "" {
+		if err := SetResourceExpiry(ctx, client, id, expiry); err != nil {
+			return err
+		}
+	}
+
 	if jsonOutput {
 		jsonId, err := json.MarshalIndent(
 			map[string]string{"id": id},

resource/expiry.go

@@ -0,0 +1,127 @@
+package resource
+
+import (
+	"context"
+	"fmt"
+	"regexp"
+	"strconv"
+	"strings"
+	"time"
+
+	"github.com/passbolt/go-passbolt/api"
+)
+
+// SetResourceExpiry updates only the expiry date of a resource.
+func SetResourceExpiry(ctx context.Context, client *api.Client, id string, expiryInput string) error {
+	if expiryInput == "" {
+		return nil
+	}
+
+	// allow a single keyword to clear expiry
+	switch strings.ToLower(strings.TrimSpace(expiryInput)) {
+	case "none":
+		_, _, err := client.DoCustomRequestAndReturnRawResponse(
+			ctx,
+			"PUT",
+			fmt.Sprintf("resources/%s.json", id),
+			"v2",
+			map[string]*string{"expired": nil},
+			nil,
+		)
+		if err != nil {
+			return fmt.Errorf("Clearing expiry: %w", err)
+		}
+		return nil
+	}
+
+	isoExpiry, err := ParseExpiry(expiryInput)
+	if err != nil {
+		return err
+	}
+	_, _, err = client.DoCustomRequestAndReturnRawResponse(
+		ctx,
+		"PUT",
+		fmt.Sprintf("resources/%s.json", id),
+		"v2",
+		map[string]string{"expired": isoExpiry},
+		nil,
+	)
+	if err != nil {
+		return fmt.Errorf("Setting expiry: %w", err)
+	}
+	return nil
+}
+
+// ParseExpiry accepts either an absolute time (ISO8601/RFC3339) or a human duration like "7d", "12h", "30m", or combinations like "1w2d3h".
+// It returns an ISO8601 (RFC3339) timestamp string in UTC suitable for the API.
+func ParseExpiry(input string) (string, error) {
+	trimmed := strings.TrimSpace(input)
+	if trimmed == "" {
+		return "", nil
+	}
+	// Try absolute timestamp first
+	if t, err := tryParseAbsoluteTime(trimmed); err == nil {
+		return t.UTC().Format(time.RFC3339), nil
+	}
+	// Fallback to human duration(s)
+	d, err := parseHumanDuration(trimmed)
+	if err != nil {
+		return "", fmt.Errorf("invalid expiry value %q: %w", input, err)
+	}
+	return time.Now().UTC().Add(d).Format(time.RFC3339), nil
+}
+
+func tryParseAbsoluteTime(s string) (time.Time, error) {
+	// Try common RFC3339 variants
+	layouts := []string{
+		time.RFC3339,
+		time.RFC3339Nano,
+		"2006-01-02T15:04:05-0700", // without colon in offset
+	}
+	var lastErr error
+	for _, layout := range layouts {
+		if t, err := time.Parse(layout, s); err == nil {
+			return t, nil
+		} else {
+			lastErr = err
+		}
+	}
+	return time.Time{}, lastErr
+}
+
+// parseHumanDuration supports segments like 1w2d3h4m5s (order-insensitive)
+func parseHumanDuration(s string) (time.Duration, error) {
+	// If it is a plain Go duration, delegate
+	if d, err := time.ParseDuration(s); err == nil {
+		return d, nil
+	}
+	re := regexp.MustCompile(`(?i)(\d+)\s*([wdhms])`)
+	matches := re.FindAllStringSubmatch(s, -1)
+	if len(matches) == 0 {
+		return 0, fmt.Errorf("cannot parse duration")
+	}
+	var total time.Duration
+	for _, m := range matches {
+		numStr := m[1]
+		unit := strings.ToLower(m[2])
+		n, err := strconv.Atoi(numStr)
+		if err != nil {
+			return 0, err
+		}
+		switch unit {
+		case "w":
+			total += time.Duration(n) * 7 * 24 * time.Hour
+		case "d":
+			total += time.Duration(n) * 24 * time.Hour
+		case "h":
+			total += time.Duration(n) * time.Hour
+		case "m":
+			total += time.Duration(n) * time.Minute
+		case "s":
+			total += time.Duration(n) * time.Second
+		default:
+			return 0, fmt.Errorf("unknown unit %q", unit)
+		}
+	}
+	return total, nil
+}

resource/update.go

@@ -24,7 +24,7 @@ func init() {
 	ResourceUpdateCmd.Flags().String("uri", "", "Resource URI")
 	ResourceUpdateCmd.Flags().StringP("password", "p", "", "Resource Password")
 	ResourceUpdateCmd.Flags().StringP("description", "d", "", "Resource Description")
-
+	ResourceUpdateCmd.Flags().String("expiry", "", "Expiry as RFC3339 (e.g. 2025-12-31T23:59:59Z), duration (e.g. 7d, 12h), or 'none' to clear")
 	ResourceUpdateCmd.MarkFlagRequired("id")
 }
 
@@ -54,6 +54,11 @@ func ResourceUpdate(cmd *cobra.Command, args []string) error {
 		return err
 	}
 
+	expiry, err := cmd.Flags().GetString("expiry")
+	if err != nil {
+		return err
+	}
+
 	ctx := util.GetContext()
 
 	client, err := util.GetClient(ctx)
@@ -76,5 +81,11 @@ func ResourceUpdate(cmd *cobra.Command, args []string) error {
 	if err != nil {
 		return fmt.Errorf("Updating Resource: %w", err)
 	}
+
+	if expiry != "" {
+		if err := SetResourceExpiry(ctx, client, id, expiry); err != nil {
+			return err
+		}
+	}
 	return nil
 }