Skip to content

fix(1.0.0): export missing config types, correct stale docs, add API smoke tests#93

Merged
scalvert merged 1 commit into
mainfrom
1.0.0-api-docs-fixes
Jun 26, 2026
Merged

fix(1.0.0): export missing config types, correct stale docs, add API smoke tests#93
scalvert merged 1 commit into
mainfrom
1.0.0-api-docs-fixes

Conversation

@scalvert

Copy link
Copy Markdown
Owner

What

Release-readiness polish surfaced by a full audit of the 1.0.0 public surface.

API completeness

  • Export FlexSearchConfig and BuiltinIndexerOptions from the main entry. Both are referenced by already-exported types (McpServerPluginOptions.flexsearch, the config union) and by the loadIndexer/loadSearchProvider signatures, but weren't exported — so a consumer couldn't name them when constructing a config.

Docs accuracy

  • README Features no longer claims "pre-built adapters for Vercel, Netlify, and Cloudflare Workers" — there's one web-standard createWebRequestHandler plus a Node dev server. CORS bullet reworded to match.
  • README props table: serverUrl/serverName are optional (they fall back to the plugin's global data), not required.
  • CONTRIBUTING: src/adapters/ description updated to the current handlers.
  • SKILL: note that dist/ is a build artifact (run npm run build, or read src).

Release hardening

  • prepublishOnly now runs lint && typecheck && test && build so a publish can't ship type/test regressions.

Tests

  • Add tests/public-exports-test.ts covering mcpServerPlugin, DEFAULT_PLUGIN_OPTIONS, the tool definitions, and createNodeHandler — exported but previously untested (+5 tests, 109 total).

Verification

build, lint, typecheck, 109 unit tests, snippet sync, and npm audit --omit=dev (0 prod vulnerabilities) all pass locally.

🤖 Generated with Claude Code

…smoke tests

- Export FlexSearchConfig and BuiltinIndexerOptions from the main entry. Both
  are referenced by already-exported types and the loadIndexer/loadSearchProvider
  signatures but weren't exported, so consumers couldn't name them.
- README Features: replace the stale "pre-built adapters for Vercel, Netlify,
  Cloudflare" bullet with the real surface (one web-standard handler + a Node
  dev server); reword the CORS bullet to match.
- README props table: serverUrl/serverName are optional (fall back to plugin
  global data), not required.
- CONTRIBUTING: update the src/adapters/ description to the current handlers.
- Harden prepublishOnly to run lint + typecheck + test before build.
- SKILL: note dist/ is a build artifact (run npm run build, or read src).
- Add tests/public-exports-test.ts covering mcpServerPlugin,
  DEFAULT_PLUGIN_OPTIONS, the tool definitions, and createNodeHandler —
  previously exported but untested.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@scalvert scalvert added the bug Something isn't working label Jun 26, 2026
@scalvert scalvert merged commit 932bb5c into main Jun 26, 2026
9 checks passed
@scalvert scalvert deleted the 1.0.0-api-docs-fixes branch June 26, 2026 22:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant