Clients return null, cannot be cancelled and drop Retry-After; the SDK reads the system clock
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 25/100
- issue の種類
- 機能追加
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- csharp, typescript
調査の方向性
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.
索引モデルが issue の本文から書いたものです。
説明
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.
- 主要言語
- C#
- スター
- 569
- フォーク
- 107
- 平均マージ
- 2時間 49分
- マージ済み PR(30日)
- 397
環境構築
- Dockerfile または Docker Compose ファイルあり
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
fluentcms/FluentCMS のほかの issue
-
area:host area:operations type:bug
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
-
area:build security type:chore
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
-
area:sdk security type:bug
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
-
area:content security type:bug
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
メンテナーはふだん 1 日以内に返信
-
area:build type:bug
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
fluentcms/FluentCMS の issue をすべて見る
似ている issue
-
bug needs-triage
難易度 2/5 1〜3時間 初心者へのやさしさ 67/100
microsoft/microsoft-ui-reactor#1567 ·
メンテナーはふだん 1 日以内に返信
-
clawsweeper:fix-shape-clear clawsweeper:queueable-fix clawsweeper:source-repro impact:ux-friction issue-rating: 🦞 diamond lobster no-stale P2
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
openclaw/openclaw-windows-node#2287 · コメント 2 件 · リアクション 1 件 ·
メンテナーはふだん 1 日以内に返信
-
kind:ux needs-triage
難易度 2/5 1〜3時間 初心者へのやさしさ 66/100
elsa-workflows/elsa-foundation#4742 ·
メンテナーはふだん 1 日以内に返信
-
priority:P2
難易度 2/5 1〜3時間 初心者へのやさしさ 88/100
-
enhancement good first issue help wanted new-language
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100