Clients return null, cannot be cancelled and drop Retry-After; the SDK reads the system clock
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 25/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- csharp, typescript
- Lĩnh vực
- backend-api-design, testing
Hướng nghiên cứu
Start with the listed locations: FluentCmsClient.cs, clients/typescript/src/client.ts, SystemOperation.cs, CmsEvent.cs, docs/analyzers.md, and Descriptors.cs; inspect the related client, SDK, and analyzer tests and the changes in #3273. The acceptance checklist defines done across six areas, from cancellation and Retry-After handling to API baselines and diagnostic documentation. This spans multiple packages and client implementations, so it requires substantial project context.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Problem
- The .NET client can return null for a non-nullable result.
FluentCmsClient.cs:120-123returnsdefaultfor an empty body or a 204, and:127returns null for a literalnullbody; callers suppress it with!(:32,39,47,55,62,71,85,92). A proxy answering 200 with an empty body gives aNullReferenceExceptionlater. - The TypeScript client has no cancellation or timeout.
clients/typescript/src/client.ts:100-105buildsRequestInitwithout asignal, and no method takes one. - Both clients discard
Retry-Afteron a 429.FluentCmsClient.cs:114andclient.ts:107-108pass only the status and body to the error. - The SDK reads the system clock directly.
src/FluentCMS.Sdk/Content/SystemOperation.cs:42andsrc/FluentCMS.Sdk/Events/CmsEvent.cs:9useDateTimeOffset.UtcNowinstead of the injectedTimeProvider. FluentCMS.Clienthas no tracked public API, unlike Sdk, Plugins.Abstractions and the two admin packages.- FCMS0100–FCMS0104 are undocumented.
docs/analyzers.md:5only reserves the range, andsrc/FluentCMS.Generators/Descriptors.cssets nohelpLinkUri, unlikesrc/FluentCMS.Analyzers/Rules.cs:22.
Proposal
- Throw
FluentCmsProblemExceptionwhen a result is expected and the body is empty ornull. - Accept a
signalper call and atimeoutMsoption in the TypeScript client. - Expose
RetryAfteron the problem type of both clients. - Take a
TimeProviderinSystemOperation; let the bus stamp events. - Add the public API analyzer and baseline to
FluentCMS.Client. - Document the five diagnostics and link them.
Done together with #3273, which changes the same two clients.
Acceptance
- An empty or
nullbody where a result is expected throws a problem exception - A TypeScript call can be aborted, and times out at
timeoutMs - A 429 exposes the
Retry-Afterof the server in both clients - No
DateTimeOffset.UtcNowremains inFluentCMS.Sdk - A change to the public API of
FluentCMS.Clientfails the build until the baseline is updated - Each of FCMS0100–FCMS0104 has a section in
docs/analyzers.mdand a help link
Found in the code review of 17 Nov 2026.
- Ngôn ngữ chính
- C#
- Star
- 569
- Fork
- 107
- Merge trung bình
- 2 giờ 49 phút
- Pull request đã merge (30 ngày)
- 397
Chuẩn bị môi trường
- Có Dockerfile hoặc tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của fluentcms/FluentCMS
-
area:host area:operations type:bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
Maintainer thường phản hồi trong vòng 1 ngày
-
area:build security type:chore
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
Maintainer thường phản hồi trong vòng 1 ngày
-
area:sdk security type:bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
Maintainer thường phản hồi trong vòng 1 ngày
-
area:content security type:bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
Maintainer thường phản hồi trong vòng 1 ngày
-
area:build type:bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của fluentcms/FluentCMS
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
Maintainer thường phản hồi trong vòng 1 ngày
-
bug needs-triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 67/100
microsoft/microsoft-ui-reactor#1567 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
clawsweeper:fix-shape-clear clawsweeper:queueable-fix clawsweeper:source-repro impact:ux-friction issue-rating: 🦞 diamond lobster no-stale P2
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
openclaw/openclaw-windows-node#2287 · 2 bình luận · 1 reaction ·
Maintainer thường phản hồi trong vòng 1 ngày
-
kind:ux needs-triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 66/100
elsa-workflows/elsa-foundation#4742 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
priority:P2
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 88/100