mirror of
https://github.com/larksuite/cli.git
synced 2026-09-14 18:42:53 +08:00
evandance
f3949f04c4
Calendar commands now return structured, typed error envelopes for every failure mode — input validation, internal faults, and API responses — instead of legacy generic errors. Callers and AI agents get consistent exit codes and a machine-readable shape (type / subtype / code / hint), and can tell bad input, an internal fault, and an API rejection apart. Validation errors are attributed to the offending flag. Server-supplied error details (e.g. why an event time was rejected) are surfaced on the typed error's hint via a shared classifier improvement that benefits every domain. Multi-step operations (create-with-attendees rollback, multi-field update) preserve the real failure's classification and report which steps completed. The whole calendar domain is now lint-locked against reintroducing legacy error constructors.
94 lines
2.8 KiB
Go
94 lines
2.8 KiB
Go
// Copyright (c) 2026 Lark Technologies Pte. Ltd.
|
|
// SPDX-License-Identifier: MIT
|
|
|
|
package calendar
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"strings"
|
|
|
|
"github.com/larksuite/cli/errs"
|
|
"github.com/larksuite/cli/internal/validate"
|
|
"github.com/larksuite/cli/shortcuts/common"
|
|
)
|
|
|
|
var CalendarRsvp = common.Shortcut{
|
|
Service: "calendar",
|
|
Command: "+rsvp",
|
|
Description: "Reply to a calendar event (accept/decline/tentative)",
|
|
Risk: "write",
|
|
Scopes: []string{"calendar:calendar.event:reply"},
|
|
AuthTypes: []string{"user", "bot"},
|
|
HasFormat: false,
|
|
Flags: []common.Flag{
|
|
{Name: "calendar-id", Desc: "calendar ID (default: primary)"},
|
|
{Name: "event-id", Desc: "event ID", Required: true},
|
|
{Name: "rsvp-status", Desc: "reply status", Required: true, Enum: []string{"accept", "decline", "tentative"}},
|
|
},
|
|
DryRun: func(ctx context.Context, runtime *common.RuntimeContext) *common.DryRunAPI {
|
|
calendarId := strings.TrimSpace(runtime.Str("calendar-id"))
|
|
d := common.NewDryRunAPI()
|
|
switch calendarId {
|
|
case "":
|
|
d.Desc("(calendar-id omitted) Will use primary calendar")
|
|
calendarId = "<primary>"
|
|
case "primary":
|
|
calendarId = "<primary>"
|
|
}
|
|
eventId := strings.TrimSpace(runtime.Str("event-id"))
|
|
status := strings.TrimSpace(runtime.Str("rsvp-status"))
|
|
|
|
return d.
|
|
POST("/open-apis/calendar/v4/calendars/:calendar_id/events/:event_id/reply").
|
|
Body(map[string]interface{}{"rsvp_status": status}).
|
|
Set("calendar_id", calendarId).
|
|
Set("event_id", eventId)
|
|
},
|
|
Validate: func(ctx context.Context, runtime *common.RuntimeContext) error {
|
|
if err := rejectCalendarAutoBotFallback(runtime); err != nil {
|
|
return err
|
|
}
|
|
for _, flag := range []string{"calendar-id", "event-id", "rsvp-status"} {
|
|
if val := strings.TrimSpace(runtime.Str(flag)); val != "" {
|
|
if err := common.RejectDangerousCharsTyped("--"+flag, val); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
}
|
|
|
|
eventId := strings.TrimSpace(runtime.Str("event-id"))
|
|
if eventId == "" {
|
|
return errs.NewValidationError(errs.SubtypeInvalidArgument, "event-id cannot be empty").WithParam("--event-id")
|
|
}
|
|
return nil
|
|
},
|
|
Execute: func(ctx context.Context, runtime *common.RuntimeContext) error {
|
|
calendarId := strings.TrimSpace(runtime.Str("calendar-id"))
|
|
if calendarId == "" {
|
|
calendarId = PrimaryCalendarIDStr
|
|
}
|
|
eventId := strings.TrimSpace(runtime.Str("event-id"))
|
|
status := strings.TrimSpace(runtime.Str("rsvp-status"))
|
|
|
|
_, err := runtime.CallAPITyped("POST",
|
|
fmt.Sprintf("/open-apis/calendar/v4/calendars/%s/events/%s/reply",
|
|
validate.EncodePathSegment(calendarId),
|
|
validate.EncodePathSegment(eventId)),
|
|
nil,
|
|
map[string]interface{}{
|
|
"rsvp_status": status,
|
|
})
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
runtime.Out(map[string]interface{}{
|
|
"calendar_id": calendarId,
|
|
"event_id": eventId,
|
|
"rsvp_status": status,
|
|
}, nil)
|
|
return nil
|
|
},
|
|
}
|