型定義ファイルのないライブラリのインポートエラーについて

型定義ファイル(.d.ts)にはアクセス可能な型宣言を記述します。
JavaScriptライブラリには型情報がないため、TypeScriptのプロジェクトで使用するときは、型定義ファイルが必要ということですね。
ただし、この型定義ファイルはすべてのライブラリに存在するわけではないため今回のように自分で仮定義する必要があります。

型定義ファイルの有無による作業の違い

今回は型定義ファイルを作成することで対応しましたが、元々型定義ファイルが存在する場合など、型定義ファイルの有無によって作業が変わってきます。

型定義ファイル有りの場合

型定義ファイルが含まれているパッケージの場合、特別な作業は必要ありません。
そのままインポートを行えば良いです。

npm install {ライブラリ名}

型定義ファイル有りだが別途インストールが必要な場合

ライブラリに型定義ファイルが同梱されていない場合は別途インストールする必要があります。
通常通りライブラリをインポートした後に @types で型定義ファイルをインポートすれば良いです。

※今回のエラー文の最初に提示されていた解決法はこれに該当します。

npm install {ライブラリ名} --save # express本体のインストール
npm install @types/{ライブラリ名} --save-dev # 型定義ファイルのインストール

型定義ファイル無し

型定義ファイルがないライブラリなので、以下のどちらかで対処できます。

• any 型で妥協する
• 型定義ファイルを作る

any型で妥協する

これは今回行った対処法です。
型定義ファイル自体が存在しないことでエラーが出ていたので、giojs.d.ts を作成しました。
型定義ファイルを作成したのでエラー自体は出なくなりましたが、詳細な型定義がされていないので暗黙的に any 型になります。

型定義ファイルを作る

型定義ファイルを自作してDefinitelyTypedに公開する対処法です。
かなり時間と労力を使う対処法にはなります。

DefinitelyTypedの日本語READ.ME

おわりに

案件で扱うようなライブラリは大体型定義ファイルに対応していることが多いので、まずは @types を試してみることをお勧めします。

時間に余裕がなければ、型定義ファイルがない場合は .d.ts ファイルで仮の型定義ファイルを作成し any 型を許容するしかない気もします。 　
型安全を担保できなくなるので、トレードオフな気もしますが。

参考記事