mirror of
https://github.com/larksuite/cli.git
synced 2026-07-06 16:18:05 +08:00
6cea6c9af0
Adds the apps domain to lark-cli for managing Miaoda (妙搭) applications: 6 shortcuts covering the full lifecycle (+create / +update / +list / +access-scope-set / +access-scope-get / +html-publish). Aligned with the OAPI v2 design — app_type enum (currently HTML), string scope enum (All / Tenant / Range), cursor pagination, in-memory tar.gz multipart publish flow. Namespace registered at /open-apis/spark/v1/ with spark:app.* scopes. --------- Co-authored-by: wangjiangwen-gif <286006750+wangjiangwen-gif@users.noreply.github.com>
80 lines
2.4 KiB
Go
80 lines
2.4 KiB
Go
// Copyright (c) 2026 Lark Technologies Pte. Ltd.
|
||
// SPDX-License-Identifier: MIT
|
||
|
||
package apps
|
||
|
||
import (
|
||
"context"
|
||
"fmt"
|
||
"io"
|
||
"strings"
|
||
|
||
"github.com/larksuite/cli/internal/output"
|
||
"github.com/larksuite/cli/shortcuts/common"
|
||
)
|
||
|
||
// AppsCreate creates a new Miaoda app.
|
||
var AppsCreate = common.Shortcut{
|
||
Service: appsService,
|
||
Command: "+create",
|
||
Description: "Create a new Miaoda app",
|
||
Risk: "write",
|
||
Scopes: []string{"spark:app:write"},
|
||
AuthTypes: []string{"user"},
|
||
HasFormat: true,
|
||
Flags: []common.Flag{
|
||
{Name: "name", Desc: "app display name", Required: true},
|
||
{Name: "app-type", Desc: "app type (currently only: HTML)", Required: true},
|
||
{Name: "description", Desc: "app description"},
|
||
{Name: "icon-url", Desc: "app icon URL (server uses default if omitted)"},
|
||
},
|
||
Validate: func(ctx context.Context, rctx *common.RuntimeContext) error {
|
||
if strings.TrimSpace(rctx.Str("name")) == "" {
|
||
return output.ErrValidation("--name is required")
|
||
}
|
||
appType := strings.TrimSpace(rctx.Str("app-type"))
|
||
if appType == "" {
|
||
return output.ErrValidation("--app-type is required")
|
||
}
|
||
if !validAppTypes[appType] {
|
||
return output.ErrValidation(fmt.Sprintf("--app-type %q is not supported (allowed: HTML)", appType))
|
||
}
|
||
return nil
|
||
},
|
||
DryRun: func(ctx context.Context, rctx *common.RuntimeContext) *common.DryRunAPI {
|
||
return common.NewDryRunAPI().
|
||
POST(apiBasePath + "/apps").
|
||
Desc("Create a Miaoda app").
|
||
Body(buildAppsCreateBody(rctx))
|
||
},
|
||
Execute: func(ctx context.Context, rctx *common.RuntimeContext) error {
|
||
data, err := rctx.CallAPI("POST", apiBasePath+"/apps", nil, buildAppsCreateBody(rctx))
|
||
if err != nil {
|
||
return err
|
||
}
|
||
rctx.OutFormat(data, nil, func(w io.Writer) {
|
||
fmt.Fprintf(w, "created: %s\n", common.GetString(data, "app_id"))
|
||
})
|
||
return nil
|
||
},
|
||
}
|
||
|
||
// 应用类型枚举。当前只有 HTML，未来会扩展（SPA、NATIVE、...）。
|
||
var validAppTypes = map[string]bool{
|
||
"HTML": true,
|
||
}
|
||
|
||
func buildAppsCreateBody(rctx *common.RuntimeContext) map[string]interface{} {
|
||
body := map[string]interface{}{
|
||
"name": strings.TrimSpace(rctx.Str("name")),
|
||
"app_type": strings.TrimSpace(rctx.Str("app-type")),
|
||
}
|
||
if desc := strings.TrimSpace(rctx.Str("description")); desc != "" {
|
||
body["description"] = desc
|
||
}
|
||
if icon := strings.TrimSpace(rctx.Str("icon-url")); icon != "" {
|
||
body["icon_url"] = icon
|
||
}
|
||
return body
|
||
}
|