Skip to main content
このページは AI コーディングエージェントスキルの一部で、人間ではなくエージェント向けに書かれています。人間向けの Base44 ドキュメントは デベロッパードキュメント を参照してください。

base44 types generate

プロジェクトリソース (entities、functions、agents、connectors) から TypeScript 宣言ファイル (types.d.ts) を生成します。

使い方

npx base44 types generate

動作

  1. プロジェクト構成を読み込みbase44/entities/base44/functions/base44/agents/base44/connectors/ をスキャンしてすべての定義済みリソースを検出
  2. base44/.types/types.d.ts を生成 — 型付きレジストリで @base44/sdk モジュールを拡張する TypeScript 宣言ファイルを作成
  3. tsconfig.json を更新 (存在する場合) — 生成された型を TypeScript が拾うように include 配列に base44/.types/*.d.ts を自動追加

認証

不要。 このコマンドは完全にローカルで実行され、認証を必要としません。

出力ファイル

生成されたファイルは以下に配置されます:
base44/.types/types.d.ts

生成される内容

宣言ファイルは 4 つのレジストリで @base44/sdk モジュールを拡張します:
  • EntityTypeRegistry — エンティティ名を対応する TypeScript インターフェースにマッピング (エンティティ JSON スキーマからコンパイル)
  • FunctionNameRegistry — すべてのバックエンド関数名をリスト
  • AgentNameRegistry — すべてのエージェント名をリスト
  • ConnectorTypeRegistry — すべてのコネクタタイプをリスト
出力例:
// Auto-generated by Base44 CLI - DO NOT EDIT
// Regenerate with: base44 types generate

export interface Task {
  title: string;
  status: "todo" | "in_progress" | "done";
  assignee?: string;
}

export interface Board {
  name: string;
  description?: string;
}

declare module '@base44/sdk' {
  interface EntityTypeRegistry {
    "Task": Task;
    "Board": Board;
  }

  interface FunctionNameRegistry {
    "send_email": true;
  }

  interface AgentNameRegistry {
    "support_agent": true;
  }

  interface ConnectorTypeRegistry {
    "googlecalendar": true;
  }
}
リソースが見つからない場合、ファイルにはリソースの追加方法を示すプレースホルダーが含まれます。

tsconfig.json との統合

プロジェクトルートに tsconfig.json が存在する場合、コマンドは include 配列に base44/.types/*.d.ts を自動追加します:
{
  "include": [
    "src",
    "base44/.types/*.d.ts"
  ]
}
パスが既に含まれている場合、または tsconfig.json が存在しない場合、このステップは静かにスキップされます。

実行タイミング

  • base44/entities/ でエンティティスキーマを作成または変更した後
  • base44/functions/ でバックエンド関数を追加または削除した後
  • base44/agents/ でエージェントを追加または削除した後
  • base44/connectors/ でコネクタを追加または削除した後
  • Base44 で TypeScript プロジェクトを初めてセットアップするとき

注意事項

  • 生成されたファイルは 手動で編集しないでください — 次回実行時に上書きされます
  • base44 types generate をビルドパイプラインまたは pre-build スクリプトに追加することを検討してください
  • .types ディレクトリは base44/ フォルダー内に自動的に作成されます
このページは AI を使用して翻訳されました。最も正確で最新の情報については、英語版 を参照してください。