- Add three installation methods (local path, npm link, copy dist)
- Fix Quick Start example to use correct API property names
- Add "Using AI Coding Agents" section with example prompts
- Reference AGENTS.md for detailed integration instructions
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Comprehensive guide for AI coding assistants to efficiently use the
Binect-JS library. Includes quick start, API methods, status codes,
helper functions, polling patterns, error handling, and complete
examples.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
SDK (@binect/js):
- BinectClient with domain sub-clients (documents, sendings, accounts,
attachments, invoices)
- HTTP Basic Auth, native fetch only (no runtime dependencies)
- TypeScript types matching Binect API vocabulary
- Status predicates and polling helpers in helpers.ts
- Structured error handling (BinectApiError, BinectAuthError)
Explorer:
- Standalone browser-based API explorer (explorer/index.html)
- Interactive testing without code
Tests:
- Unit tests for client, types, errors, helpers, http
- E2E tests for upload/delete and send/cancel workflows
Also includes:
- Architecture Decision Records (ADRs)
- Example DIN 5008 letter PDFs for testing
- API specification research notes
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Tests the full letter lifecycle: upload → send → poll for status
transition → cancel. Includes polling logic to wait for document
status to transition from IN_PREPARATION to PRODUCTION_QUEUE before
attempting cancel. Gracefully handles insufficient balance errors.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add PRD and TSD defining SDK and Explorer architecture
- Add CLAUDE.md with project guidance for Claude Code
- Update README with project description
- Replace Python .gitignore with JS/TS configuration
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
