Skip to content

Fix spec issues and add endpoint documentation#1

Merged
svperfecta merged 3 commits intomainfrom
fix/spec-cleanup-and-docs
Feb 8, 2026
Merged

Fix spec issues and add endpoint documentation#1
svperfecta merged 3 commits intomainfrom
fix/spec-cleanup-and-docs

Conversation

@svperfecta
Copy link
Contributor

Summary

  • Fix 249 empty response descriptions (required by OpenAPI 3.0)
  • Add 5 missing global tag definitions (Bank Reconciliation, Company Objects, Custom Fields, Integrations, coa)
  • Remove 518 exclusiveMin/Max boolean noise (JSON Schema draft-4 artifacts)
  • Replace 32 oneOf with BlankEnum/NullEnum patterns with allOf+nullable (fixes duplicate enum TS compilation errors)
  • Remove orphaned BlankEnum/NullEnum schemas
  • Add summaries and descriptions to 31 previously undocumented operations (sourced from Campfire API reference docs)

Test plan

  • just build compiles without errors
  • speakeasy lint openapi -s campfire.json returns 0 errors, 0 warnings
  • JSON diff against original spec confirms no functional changes (only documentation and spec compliance fixes)
  • All 318 operations now have at least a summary or description

🤖 Generated with Claude Code

svperfecta and others added 3 commits February 7, 2026 18:50
- Fix 249 empty response descriptions (required by OpenAPI 3.0)
- Add 5 missing global tag definitions (Bank Reconciliation, Company Objects, etc.)
- Remove 518 exclusiveMin/Max boolean noise (draft-4 artifacts)
- Replace 32 oneOf-with-BlankEnum/NullEnum patterns with allOf+nullable
- Remove orphaned BlankEnum/NullEnum schemas
- Add summaries and descriptions to 31 undocumented operations

Speakeasy lint: 0 errors, 0 warnings.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
These are valid OAS 3.0.3 boolean-style bounds paired with real
minimum/maximum values (e.g. Django decimal field constraints like
-1e18 to 1e18). Removing them discarded meaningful schema information.

Speakeasy warns about them (prefers OAS 3.1 number style) but they
are spec-compliant and useful for LLMs reading the schema.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- README/CLAUDE.md: Replace DefaultApi references with actual generated
  classes (CashManagementApi, AccountsPayableApi, etc.)
- README: Add API classes table with descriptions
- CLAUDE.md: Add full list of 12 API classes, key conventions (soft-delete,
  bulk search, double-entry, multi-currency, void/reopen, closed books)
- .openapi-generator-ignore: Protect campfire.json from being overwritten
- Repo: Add topics (typescript, sdk, campfire, openapi) and homepage URL

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@svperfecta svperfecta merged commit 96fc43b into main Feb 8, 2026
1 check passed
@svperfecta svperfecta deleted the fix/spec-cleanup-and-docs branch February 8, 2026 00:06
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