mirror of
https://github.com/larksuite/cli.git
synced 2026-09-14 18:42:53 +08:00
evandance
5e6a3eb857
* feat(mail): return typed error envelopes across the mail domain Replace every produced error path in shortcuts/mail with typed errs.* envelopes, so consumers get stable category, subtype, param/params, hint, retryable, and log_id metadata for classification and recovery instead of free-form message text. - Locally constructed mail errors move from output.Err* / output.Errorf / final fmt.Errorf / common legacy helpers to errs.* builders, with structured params on multi-flag validation and failed-precondition states kept non-retryable. - API-call failures move from runtime.CallAPI / DoAPIJSON legacy boundaries to runtime.CallAPITyped or runtime.ClassifyAPIResponse, and mail-specific enrichers read errs.ProblemOf so typed code, subtype, hint, and log_id metadata are preserved. - Batch draft-send partial failures now use runtime.OutPartialFailure so successful and failed draft sends stay in stdout while the command exits through a typed multi-status signal. - Add mail-domain typed helpers, mail API code metadata, and guard wiring to keep shortcuts/mail from reintroducing legacy envelopes or legacy API calls. - Keep genuine intermediate fmt.Errorf wraps in parser/builder layers annotated with nolint comments; command-facing paths wrap them into typed validation, API, network, or internal errors. * fix(mail): report aborted draft-send batches as a single failure result When an account-level failure interrupts a batch send after some drafts already went out, the command previously produced two machine-readable failure results: the partial-failure ledger on stdout and a second error envelope on stderr. Consumers could not tell which one to recover from. The batch ledger is now the only failure result for that case: it gains aborted and abort_error fields carrying the typed cause, so callers can see which drafts were sent, which failed, why the batch stopped, and how to recover — all from stdout. A --stop-on-error stop keeps these fields unset because stopping early there is the caller's own choice.
65 lines
1.5 KiB
Go
65 lines
1.5 KiB
Go
// Copyright (c) 2026 Lark Technologies Pte. Ltd.
|
|
// SPDX-License-Identifier: MIT
|
|
|
|
package draft
|
|
|
|
import (
|
|
"bytes"
|
|
"fmt"
|
|
"io"
|
|
"strings"
|
|
|
|
htmlcharset "golang.org/x/net/html/charset"
|
|
"golang.org/x/text/transform"
|
|
)
|
|
|
|
func isTextualMediaType(mediaType string) bool {
|
|
return strings.HasPrefix(strings.ToLower(strings.TrimSpace(mediaType)), "text/")
|
|
}
|
|
|
|
func normalizeCharsetLabel(label string) string {
|
|
label = strings.TrimSpace(label)
|
|
label = strings.Trim(label, `"`)
|
|
return label
|
|
}
|
|
|
|
func isUTF8LikeCharset(label string) bool {
|
|
switch strings.ToLower(normalizeCharsetLabel(label)) {
|
|
case "", "utf-8", "utf8", "us-ascii", "ascii":
|
|
return true
|
|
default:
|
|
return false
|
|
}
|
|
}
|
|
|
|
func decodeTextCharset(body []byte, label string) ([]byte, error) {
|
|
if isUTF8LikeCharset(label) {
|
|
return body, nil
|
|
}
|
|
reader, err := htmlcharset.NewReaderLabel(label, bytes.NewReader(body))
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return io.ReadAll(reader)
|
|
}
|
|
|
|
func encodeTextCharset(body []byte, label string) ([]byte, error) {
|
|
if isUTF8LikeCharset(label) {
|
|
return body, nil
|
|
}
|
|
enc, _ := htmlcharset.Lookup(label)
|
|
if enc == nil {
|
|
return nil, fmt.Errorf("unsupported charset %q", label) //nolint:forbidigo // intermediate draft charset error; mail command layer wraps into typed ValidationError.
|
|
}
|
|
var buf bytes.Buffer
|
|
writer := transform.NewWriter(&buf, enc.NewEncoder())
|
|
if _, err := writer.Write(body); err != nil {
|
|
_ = writer.Close()
|
|
return nil, err
|
|
}
|
|
if err := writer.Close(); err != nil {
|
|
return nil, err
|
|
}
|
|
return buf.Bytes(), nil
|
|
}
|