Skip to content

fix(typefully): improve invalid API key UX - #27

Merged
linuz90 merged 2 commits into
mainfrom
fab/typefully-auth-failure-ux
Jul 8, 2026
Merged

fix(typefully): improve invalid API key UX#27
linuz90 merged 2 commits into
mainfrom
fab/typefully-auth-failure-ux

Conversation

@linuz90

@linuz90 linuz90 commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

TL;DR

Broken or expired Typefully API keys now produce a clear authentication failure instead of a generic HTTP 401 or a softened setup warning. The skill instructions also tell agents to stop and ask the user to refresh setup, rather than falling back to browser, web UI, or localhost access.

Root Cause

The CLI only had hard-stop handling for missing API keys. Invalid keys came back as generic 401 API errors, and setup/default-social-set paths wrapped those errors as softer fetch/access failures, leaving agents room to improvise another access path.

Summary

  • Fix 401 auth handling by adding a shared authentication failure message and details for Typefully API 401 responses.
  • Fix setup and default social set flows so invalid keys also hard-stop with setup guidance instead of being wrapped as generic fetch/access failures.
  • Update agent-facing docs and changelog to cover missing, invalid, and expired keys, and explicitly forbid web UI/browser/localhost fallback for draft access.
  • Clarify X Article Markdown review guidance so agents do not flag Typefully-normalized bold/link Markdown as broken when the rendered article is correct.
  • Clean up dated changelog sections so shipped Typefully skill entries use plain date headings instead of Unreleased or bracketed dates.
  • Add regression coverage for direct API calls, setup default validation, setup social-set discovery, and default social set configuration.

Validation

  • git diff --check
  • npm run test:common
  • npm run test:config
  • npm test

After Merge

  • Users with an installed copy of the Typefully skill should update it through their normal skills.sh / Claude plugin flow to receive the new behavior.

@linuz90
linuz90 force-pushed the fab/typefully-auth-failure-ux branch from 8b7e0fd to ff14c4a Compare July 8, 2026 13:37
@linuz90
linuz90 merged commit 2b48317 into main Jul 8, 2026
2 checks passed
@linuz90
linuz90 deleted the fab/typefully-auth-failure-ux branch July 8, 2026 13:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant