動的な型 - Base44 Support Documentation

TypeScript プロジェクトで Base44 を使う際は、動的な型を利用できます。エンティティ、関数、エージェント、コネクターには対応する TypeScript の型があり、以下を提供します。

オートコンプリート: IDE が利用可能なエンティティ、フィールド、関数、エージェント、コネクター integration type を提案します。
型安全性: タイプミスや無効なフィールドを実行時ではなくコンパイル時に検出します。
ドキュメント: IDE で型にカーソルを合わせると、フィールドの説明と型が表示されます。

仕組み

Base44 はバックエンド構成を読み取り、プロジェクトの型で SDK を拡張する base44/.types/types.d.ts ファイルを作成します。型ファイルには以下が含まれます。

型付きフィールドと CRUD 操作を持つエンティティスキーマ
オートコンプリート用の関数名
オートコンプリート用のエージェント名
オートコンプリート用のコネクター integration type 名

エンティティの型

動的な型は、すべてのエンティティ操作に対して完全な型安全性を提供します。エンティティフィールド、戻り値の型、パラメーターはすべて厳密に型付けされます。

import type { EntityRecord } from "@base44/sdk";

type TaskRecord = EntityRecord["Task"];

// All fields are typed
const task = await base44.entities.Task.create({
  title: "Complete documentation",
  status: "in-progress",
  priority: "high",
});

// Return type includes both your fields and server fields
console.log(task.id); // Server field
console.log(task.created_date); // Server field
console.log(task.title); // Your field

// Get with full type safety
const retrieved = await base44.entities.Task.get(task.id);

// Update with type checking
await base44.entities.Task.update(task.id, {
  status: "completed",
});

関数の型

関数名は、関数を呼び出すときのオートコンプリート用に型付けされます。

// Autocomplete shows all available functions
const result = await base44.functions.invoke("calculateTotal", {
  items: ["item1", "item2"],
});

関数のパラメーター型は生成されません。期待されるパラメーターについては関数の実装を参照してください。

エージェントの型

エージェント名は、会話を扱うときのオートコンプリート用に型付けされます。

// Autocomplete shows all available agents
const conversation = await base44.agents.createConversation("SupportBot");

コネクターの型

コネクター integration type 名は、接続を取得するときのオートコンプリート用に型付けされます。

// Autocomplete shows all available connector integration types
const { accessToken } = await base44.asServiceRole.connectors.getConnection(
  "googlecalendar"
);

connectors モジュールはサービスロールモード (バックエンド環境) でのみ利用可能です。

型を生成する

型ファイルを生成または更新するには、types generate コマンドを実行します。

base44 types generate

エンティティを変更したり、関数を追加したり、エージェントを変更したりした際は、型を最新の状態に保つために types generate を再実行してください。

​仕組み

​エンティティの型

​関数の型

​エージェントの型

​コネクターの型

​型を生成する

​関連項目

仕組み

エンティティの型

関数の型

エージェントの型

コネクターの型

型を生成する

関連項目