push reports a missing handle when TSCIRCUIT_TOKEN account lookup fails
Maintainer thường phản hồi trong vòng 1 ngày
@VB-Blue đang làm issue này rồi.
Từ ngày 16/11/2026.
- #5286 của @danya0003 — đã đóng, không merge
- #5366 của @prajwal-0706 — đã đóng, không merge
- #5441 của @duongynhi000005-oss — đã đóng, không merge
- #5578 của @1932819331hy-debug — đã đóng, không merge
- #5641 của @tungnguyen84 — đã đóng, không merge
- #5659 của @BrandoBlue — đã đóng, không merge
- #5733 của @cocvn157 — đã đóng, không merge
- #5737 của @jeffrey-graham — đã đóng, không merge
- #5826 của @VB-Blue — đang mở
Đánh giá
- Độ khó
- 4/5
- Thời gian dự kiến
- 3-5 ngày
- Mức phù hợp với người mới
- 25/100
- Loại issue
- Lỗi
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Đình trệ
- Công nghệ
- bun, typescript
- Lĩnh vực
- authentication, cli
Hướng nghiên cứu
Start with lib/registry-api/fetch-account.ts and its callers in lib/shared/push-snippet.ts; inspect how lookup failures become null and how push, whoami, login, and initialization handle that result. Review the existing tests for environment-token publishing and expiry guidance, then add coverage for successful lookup, missing handles, HTTP errors, network errors, and malformed responses. Done means lookup failures preserve useful errors and exit nonzero, while a successfully retrieved account without a handle still gets the existing message.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Problem
tsci push reports that the user needs to set a tscircuit handle when an authenticated account lookup fails. It discards the underlying HTTP, network or response-parsing error, so a service failure or expired token is presented as missing account metadata.
We encountered this while making and publishing the USB-C rechargeable bicycle brake-light board entirely with tscircuit. The Devesh36 account already had a handle, and we were publishing from the cloud environment using TSCIRCUIT_TOKEN. The network/proxy returned HTTP 503 for the account lookup, but the CLI printed:
You need to set your tscircuit handle to publish packages
Publishing succeeded later when connectivity recovered, without setting a new handle.
Reproduction
The failure can be reproduced without a real token, registry outage or upload. From a CLI repository checkout with dependencies installed, run:
CLI_ENTRY="$PWD/cli/main.ts"
REPRO_DIR=$(mktemp -d)
cd "$REPRO_DIR"
cat > package.json <<'JSON'
{"name":"@tsci/test-user.handle-error-repro","version":"0.0.0"}
JSON
cat > index.circuit.tsx <<'TSX'
export default () => null
TSX
cat > mock-account-503.ts <<'TS'
globalThis.fetch = (async (input: Request | URL | string) => {
const url = typeof input === "string" || input instanceof URL
? String(input) : input.url
if (new URL(url).pathname === "/accounts/get") {
return Response.json(
{ error: { error_code: "service_unavailable", message: "Simulated outage" } },
{ status: 503 },
)
}
throw new Error("Unexpected request blocked by reproduction")
}) as typeof fetch
TS
TSCIRCUIT_TOKEN=placeholder-token \
TSCIRCUIT_CONFIG_DIR="$REPRO_DIR/.config" \
bun --preload ./mock-account-503.ts "$CLI_ENTRY" push index.circuit.tsx
Actual: missing-handle message, exit code 1. Only /accounts/get is attempted; no upload occurs.
Expected: an account-verification failure that preserves the service error, for example:
Could not verify your account for publishing: registry returned HTTP 503.
Retry when the registry is available.
The missing-handle message should apply only after successfully retrieving an account that actually lacks a handle.
Cause
When TSCIRCUIT_TOKEN is set, push-snippet.ts gets the publishing handle through fetchAccount().
fetch-account.ts catches every request/parsing exception and returns null. The caller then treats the absent handle as proof that the user must set one. This also swallows the HTTP client's existing expired-session guidance.
The environment-token publishing path was introduced in #5131. The saved-session path reads the cached handle directly and does not make this account lookup at that step.
Additional verification
We exercised 17 controlled CLI scenarios with placeholder tokens and intercepted requests. These all incorrectly produced the same missing-handle message:
- HTTP 503, 401 with
session_expired, 403 and 429; - connection failure and an injected timeout exception;
- HTTP 200 with malformed JSON or a missing account object;
- HTTP 503 even when a valid handle was already saved alongside the environment token.
A valid account with a handle passed account validation. A valid account without a handle correctly produced the existing message. No-token input correctly requested login. The success controls were stopped before any release lookup or publication, and all project manifests remained unchanged.
The shared helper also makes auth whoami print @(not set) and exit 0 after account lookup fails, and login can print Already logged in as @undefined! when no saved handle is available.
Suggested fix and regression coverage
Distinguish failed lookup from a successfully retrieved account with no handle, and report lookup failures with a nonzero exit code. Preserve useful authentication/status information. Do not fall back to a cached handle for an environment-token failure, since that token may identify another account.
Update affected callers of fetchAccount deliberately: push, whoami, login, and initialization's optional author lookup. Tests should cover a successful lookup, a genuinely missing handle, HTTP 503, expired token, network error and malformed response. Existing tests cover successful environment-token publishing and lower-level expiry messages but miss this swallowed-error path.
Environment
- Observed and reproduced with
[email protected],@tscircuit/[email protected], Bun 1.4.0. - The same implementation remains in reviewed upstream CLI 0.1.2294, commit
3945316bf27f9ff4ba2b16a1683b9c2810446f82.
- Ngôn ngữ chính
- TypeScript
- Star
- 19
- Fork
- 115
- Merge trung bình
- 1 giờ 50 phút
- Pull request đã merge (30 ngày)
- 260
Chuẩn bị môi trường
Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.
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 tscircuit/cli
-
`tsci check` and `tsci check netlist` exit 0 when they report errorsCó thể đã có người làm @aswadi đã nhận 5 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 57/100
Maintainer thường phản hồi trong vòng 1 ngày
-
@tscircuit/cli 0.1.2452 bundles brace-expansion 2.0.1 and minimatch 5.1.2 (via make-vfs), both with published advisoriesCó thể làm lại được Pull request cho issue này đã bị đóng mà không được merge. Đang mở
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 48/100
Maintainer thường phản hồi trong vòng 1 ngày
-
tsci dev: ngspice spiceEngine from tscircuit.config.ts fails three ways (package.json, top-level await, blob import)Có thể đã có người làm @cocvn157 đã nhận 12 ngày trước. Đang mở
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 22/100
Maintainer thường phản hồi trong vòng 1 ngày
-
tsci export -f glb can't load a relative cadModel stepUrl (404); build --glbs canCó thể đã có người làm @jeffrey-graham đã nhận 10 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 25/100
Maintainer thường phản hồi trong vòng 1 ngày
-
The CLI needs Bun: under Node alone `tsci` fails and the Node entry can't load `.tsx`Có thể đã có người làm @cocvn157 đã nhận 9 ngày trước. Đang mở
Độ khó 4/5 1-2 ngày Mức phù hợp với người mới 35/100
tscircuit/cli#5449 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của tscircuit/cli
Issue tương tự
-
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 83/100
gofish-graphics/gofish-graphics#1384 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
adapter bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 83/100
Olanetsoft/agent-lookout#353 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
vicharanashala/vibe#1542 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug chore P2 size:XS
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 77/100
josephfung/curia#2666 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug good first issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 84/100
devarshishimpi/codra#178 ·
Maintainer thường phản hồi trong vòng 1 ngày