中国の開発者が、株式市場SDK（stock-sdk）をバージョン1からバージョン2に書き換えた詳細なポストモーテムを公開しました。元のv1は18回のリリースを経て有機的に成長し、単一のファサードクラスに105のフラットなgetterメソッドが蓄積されていました。v2のリデザインでは、APIサーフェスを完全に再考：メソッドを名前空間にグループ化し、サブパスがツリーシェイクをサポートしてバンドルを小型化、データコントラクトとエラータイプを統一、シンボル正規化を集中化。さらにCLI、MCP、プレイグラウンドツールも導入。金融データSDKに特化した内容ですが、フラットAPIの肥大化回避、ツリーシェイク対応設計、エラーハンドリングの標準化といったアーキテクチャの教訓は、公開ライブラリを保守するあらゆる開発者に広く適用可能です。
開発者が18回のイテレーションを経て株式市場SDKを完全に書き換えた経験を共有。v2では肥大化したAPIを名前空間に統合し、ツリーシェイク対応、エラーハンドリングとシンボル正規化を標準化。ライブラリをプロダクショングレードに進化させる実践例。