ここでカバーする最新パッチ:v4.0.1(2026-05-30 リリース)。
要件
- Node.js 20.0.0 以降(v3 は Node 18 をサポートしていました)
破壊的変更の概要
リネーム
client.users → client.user
api.users は api.user へプロキシする非推奨のゲッターとして引き続きエクスポートされますが、実行時に警告を出力します。
Backups → Snapshots
Backup エクスポートは現在、Snapshot の非推奨エイリアスです。
Application
Application.custom
カスタムドメインがバインドされていない場合、app.custom は現在 null になりました(v3 では undefined でした)。
app.commit(file, fileName, restart)
第 3 引数の restart は削除されました。commit 後は手動で再起動してください。
app.files.create(content, path)
シグネチャは現在 create(content, fileName, path = "/") です。移行方法:
Deploys
app.deploys.list() の形式
Deployment.id
`git-…` 形式の文字列ではなく、単なるコミットの SHA-1(40 桁の 16 進数)になりました。
Network
app.network.dns()
app.network.analytics()
app.network.purgeCache()
Workspaces
v4 の新機能
上記のリネームやシグネチャ変更に加えて、v4 では大幅な機能セットが追加されています。- Databases — 完全なライフサイクル、認証情報、snapshot、メトリクス(Databases)
- Workspaces — 招待コードとロールによるチームコラボレーション(Workspaces)
- 環境変数 — list / set / replace / delete(環境変数)
- アプリケーションメトリクス — 24 時間分の CPU/RAM/ネットワークサンプル(アプリケーションの管理)
- リアルタイム SSE ストリーム —
app.realtime()(Realtime) - エッジ分析 — analytics、errors、logs、latency のパーセンタイル(Network)
- GitHub App 連携 —
app.deploys.linkGithubApp({ ... })(Deploys) - snapshot の復元 —
app.snapshots.restore({ snapshotId, versionId })とdb.snapshots.restore(snapshotId, versionId) - status-all エンドポイント —
api.applications.statusAll()、api.databases.statusAll() - サービスステータス —
api.service.status() - ユーザースコープの snapshot —
api.user.snapshots(scope) - 新しい User フィールド —
User.locale、User.createdAt、User.databases - 新しい BaseApplication フィールド —
domain、custom、createdAt SquareCloudAPIError.code—switchベースのエラーハンドリング用に公開

