71 lines
2.9 KiB
Markdown
71 lines
2.9 KiB
Markdown
|
# bunq API Client Implementation Plan
|
||
|
|
|
||
|
|
cat /home/philkunz/.claude/CLAUDE.md
|
||
|
|
|
||
|
|
## Phase 1: Remove External Dependencies & Setup Core Infrastructure
|
||
|
|
|
||
|
|
- [x] Remove @bunq-community/bunq-js-client dependency from package.json
|
||
|
|
- [x] Remove JSONFileStore and bunqCommunityClient from bunq.plugins.ts
|
||
|
|
- [x] Create bunq.classes.apicontext.ts for API context management
|
||
|
|
- [x] Create bunq.classes.httpclient.ts for HTTP request handling
|
||
|
|
- [x] Create bunq.classes.crypto.ts for cryptographic operations
|
||
|
|
- [x] Create bunq.classes.session.ts for session management
|
||
|
|
- [x] Create bunq.interfaces.ts for shared interfaces and types
|
||
|
|
|
||
|
|
## Phase 2: Implement Core Authentication Flow
|
||
|
|
|
||
|
|
- [x] Implement RSA key pair generation in crypto class
|
||
|
|
- [x] Implement installation endpoint (`POST /v1/installation`)
|
||
|
|
- [x] Implement device registration (`POST /v1/device-server`)
|
||
|
|
- [x] Implement session creation (`POST /v1/session-server`)
|
||
|
|
- [x] Implement request signing mechanism
|
||
|
|
- [x] Implement response verification
|
||
|
|
- [x] Add session token refresh logic
|
||
|
|
|
||
|
|
## Phase 3: Update Existing Classes
|
||
|
|
|
||
|
|
- [x] Refactor BunqAccount class to use new HTTP client
|
||
|
|
- [x] Update BunqMonetaryAccount to work with new infrastructure
|
||
|
|
- [x] Update BunqTransaction to work with new infrastructure
|
||
|
|
- [x] Add proper TypeScript interfaces for all API responses
|
||
|
|
- [x] Implement error handling with bunq-specific error types
|
||
|
|
|
||
|
|
## Phase 4: Implement Additional API Resources
|
||
|
|
|
||
|
|
- [x] Create bunq.classes.user.ts for user management
|
||
|
|
- [x] Create bunq.classes.payment.ts for payment operations
|
||
|
|
- [x] Create bunq.classes.card.ts for card management
|
||
|
|
- [x] Create bunq.classes.request.ts for payment requests
|
||
|
|
- [x] Create bunq.classes.schedule.ts for scheduled payments
|
||
|
|
- [x] Create bunq.classes.draft.ts for draft payments
|
||
|
|
- [x] Create bunq.classes.attachment.ts for file handling
|
||
|
|
- [x] Create bunq.classes.export.ts for statement exports
|
||
|
|
- [x] Create bunq.classes.notification.ts for notifications
|
||
|
|
- [x] Create bunq.classes.webhook.ts for webhook management
|
||
|
|
|
||
|
|
## Phase 5: Enhanced Features
|
||
|
|
|
||
|
|
- [x] Implement pagination support for all list endpoints
|
||
|
|
- [x] Add rate limiting compliance
|
||
|
|
- [x] Implement retry logic with exponential backoff
|
||
|
|
- [x] Add request/response logging capabilities
|
||
|
|
- [x] Implement webhook signature verification
|
||
|
|
- [x] Add OAuth flow support for third-party apps
|
||
|
|
|
||
|
|
## Phase 6: Testing & Documentation
|
||
|
|
|
||
|
|
- [ ] Write unit tests for crypto operations
|
||
|
|
- [ ] Write unit tests for HTTP client
|
||
|
|
- [ ] Write unit tests for all API classes
|
||
|
|
- [ ] Create integration tests using sandbox environment
|
||
|
|
- [x] Update main README.md with usage examples
|
||
|
|
- [x] Add JSDoc comments to all public methods
|
||
|
|
- [x] Create example scripts for common use cases
|
||
|
|
|
||
|
|
## Phase 7: Cleanup & Optimization
|
||
|
|
|
||
|
|
- [x] Remove all references to old bunq-community client
|
||
|
|
- [x] Optimize bundle size
|
||
|
|
- [x] Ensure all TypeScript types are properly exported
|
||
|
|
- [x] Run build and verify all tests pass
|
||
|
|
- [x] Update package version
|