Skip to main content
ここでカバーする最新パッチ:v4.0.1(2026-05-30 リリース)。

要件

  • Node.js 20.0.0 以降(v3 は Node 18 をサポートしていました)

破壊的変更の概要

リネーム

client.usersclient.user

api.usersapi.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()
  • ユーザースコープの snapshotapi.user.snapshots(scope)
  • 新しい User フィールドUser.localeUser.createdAtUser.databases
  • 新しい BaseApplication フィールドdomaincustomcreatedAt
  • SquareCloudAPIError.codeswitch ベースのエラーハンドリング用に公開