// Copyright (c) 2026 Lark Technologies Pte. Ltd. // SPDX-License-Identifier: MIT package doc import ( "bytes" "encoding/json" "strings" "testing" "github.com/larksuite/cli/internal/cmdutil" "github.com/larksuite/cli/internal/core" "github.com/larksuite/cli/internal/httpmock" "github.com/larksuite/cli/shortcuts/common" ) // ── V2 (OpenAPI) tests ── func TestDocsCreateV2BotAutoGrantSuccess(t *testing.T) { t.Parallel() f, stdout, _, reg := cmdutil.TestFactory(t, docsCreateTestConfig(t, "ou_current_user")) registerDocsCreateAPIStub(reg, map[string]interface{}{ "document": map[string]interface{}{ "document_id": "doxcn_new_doc", "revision_id": float64(1), "url": "https://example.feishu.cn/docx/doxcn_new_doc", }, }) permStub := &httpmock.Stub{ Method: "POST", URL: "/open-apis/drive/v1/permissions/doxcn_new_doc/members", Body: map[string]interface{}{ "code": 0, "msg": "ok", "data": map[string]interface{}{ "member": map[string]interface{}{ "member_id": "ou_current_user", "member_type": "openid", "perm": "full_access", }, }, }, } reg.Register(permStub) err := runDocsCreateShortcut(t, f, stdout, []string{ "+create", "--content", "
正文
", "--as", "bot", }) if err != nil { t.Fatalf("unexpected error: %v", err) } data := decodeDocsCreateEnvelope(t, stdout) grant, _ := data["permission_grant"].(map[string]interface{}) if grant["status"] != common.PermissionGrantSkipped { t.Fatalf("permission_grant.status = %#v, want %q", grant["status"], common.PermissionGrantSkipped) } if _, ok := grant["user_open_id"]; ok { t.Fatalf("did not expect user_open_id when current user is missing: %#v", grant) } if !strings.Contains(stderr.String(), "auto-grant was skipped") { t.Fatalf("stderr missing auto-grant skipped warning; got:\n%s", stderr.String()) } } func TestDocsCreateV2UserSkipsPermissionGrantAugmentation(t *testing.T) { t.Parallel() f, stdout, _, reg := cmdutil.TestFactory(t, docsCreateTestConfig(t, "ou_current_user")) registerDocsCreateAPIStub(reg, map[string]interface{}{ "document": map[string]interface{}{ "document_id": "doxcn_new_doc", "revision_id": float64(1), "url": "https://example.feishu.cn/docx/doxcn_new_doc", }, }) err := runDocsCreateShortcut(t, f, stdout, []string{ "+create", "--api-version", "v2", "--content", "正文
", "--as", "user", }) if err != nil { t.Fatalf("unexpected error: %v", err) } data := decodeDocsCreateEnvelope(t, stdout) if _, ok := data["permission_grant"]; ok { t.Fatalf("did not expect permission_grant in user mode output: %#v", data) } } func TestDocsCreateV2BotAutoGrantFailureDoesNotFailCreate(t *testing.T) { t.Parallel() f, stdout, stderr, reg := cmdutil.TestFactory(t, docsCreateTestConfig(t, "ou_current_user")) registerDocsCreateAPIStub(reg, map[string]interface{}{ "document": map[string]interface{}{ "document_id": "doxcn_new_doc", "revision_id": float64(1), "url": "https://example.feishu.cn/docx/doxcn_new_doc", }, }) permStub := &httpmock.Stub{ Method: "POST", URL: "/open-apis/drive/v1/permissions/doxcn_new_doc/members", Body: map[string]interface{}{ "code": 230001, "msg": "no permission", }, } reg.Register(permStub) err := runDocsCreateShortcut(t, f, stdout, []string{ "+create", "--api-version", "v2", "--content", "正文
", "--as", "bot", }) if err != nil { t.Fatalf("document creation should still succeed when auto-grant fails, got: %v", err) } data := decodeDocsCreateEnvelope(t, stdout) grant, _ := data["permission_grant"].(map[string]interface{}) if grant["status"] != common.PermissionGrantFailed { t.Fatalf("permission_grant.status = %#v, want %q", grant["status"], common.PermissionGrantFailed) } if !strings.Contains(grant["message"].(string), "full_access (可管理权限)") { t.Fatalf("permission_grant.message = %q, want permission hint", grant["message"]) } if !strings.Contains(grant["message"].(string), "retry later") { t.Fatalf("permission_grant.message = %q, want retry guidance", grant["message"]) } if !strings.Contains(stderr.String(), "auto-grant failed") { t.Fatalf("stderr missing auto-grant failed warning; got:\n%s", stderr.String()) } } func TestDocsCreateV2FallbackURLWhenBackendOmitsIt(t *testing.T) { t.Parallel() f, stdout, _, reg := cmdutil.TestFactory(t, docsCreateTestConfig(t, "")) registerDocsCreateAPIStub(reg, map[string]interface{}{ "document": map[string]interface{}{ "document_id": "doxcn_new_doc", "revision_id": float64(1), // "url" deliberately omitted to exercise the fallback. }, }) err := runDocsCreateShortcut(t, f, stdout, []string{ "+create", "--api-version", "v2", "--content", "正文
", "--as", "user", }) if err != nil { t.Fatalf("unexpected error: %v", err) } data := decodeDocsCreateEnvelope(t, stdout) doc, _ := data["document"].(map[string]interface{}) if doc == nil { t.Fatalf("missing document in envelope: %#v", data) } if got, want := doc["url"], "https://www.feishu.cn/docx/doxcn_new_doc"; got != want { t.Fatalf("document.url = %#v, want %q (brand-standard fallback)", got, want) } } func TestDocsCreateV2PreservesBackendURL(t *testing.T) { t.Parallel() f, stdout, _, reg := cmdutil.TestFactory(t, docsCreateTestConfig(t, "")) registerDocsCreateAPIStub(reg, map[string]interface{}{ "document": map[string]interface{}{ "document_id": "doxcn_new_doc", "revision_id": float64(1), "url": "https://tenant.larkoffice.com/docx/doxcn_new_doc", }, }) err := runDocsCreateShortcut(t, f, stdout, []string{ "+create", "--api-version", "v2", "--content", "正文
", "--as", "user", }) if err != nil { t.Fatalf("unexpected error: %v", err) } data := decodeDocsCreateEnvelope(t, stdout) doc, _ := data["document"].(map[string]interface{}) if got, want := doc["url"], "https://tenant.larkoffice.com/docx/doxcn_new_doc"; got != want { t.Fatalf("document.url = %#v, want backend tenant URL %q (fallback must not overwrite)", got, want) } } func TestDocsCreateAPIVersionV1StillUsesV2Endpoint(t *testing.T) { t.Parallel() f, stdout, _, reg := cmdutil.TestFactory(t, docsCreateTestConfig(t, "")) registerDocsCreateAPIStub(reg, map[string]interface{}{ "document": map[string]interface{}{ "document_id": "doxcn_new_doc", "revision_id": float64(1), "url": "https://example.feishu.cn/docx/doxcn_new_doc", }, }) err := runDocsCreateShortcut(t, f, stdout, []string{ "+create", "--api-version", "v1", "--content", "