Dynamic Types

When you work with Base44 in a TypeScript project, you can use dynamic types. Your entities, functions, agents, and connectors have corresponding TypeScript types that provide:

Autocomplete: Your IDE suggests available entities, fields, functions, agents, and connector integration types.
Type safety: Catch typos and invalid fields at compile time instead of runtime.
Documentation: Hover over types in your IDE to see field descriptions and types.

How it works

Base44 reads your backend configuration and creates a base44/.types/types.d.ts file that augments the SDK with types from your project. The types file includes:

Entity schemas with typed fields and CRUD operations
Function names for autocomplete
Agent names for autocomplete
Connector integration type names for autocomplete

Entity types

Dynamic types provide full type safety for all entity operations. Your entity fields, return types, and parameters are all strongly typed.

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",
});

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

type TaskRecord = EntityRecord["Task"];

// Only get specific fields using autocomplete
const tasks = await base44.entities.Task.list("-created_date", 10, 0, [
  "title",
  "status",
]);

// TypeScript knows only selected fields are available
tasks.forEach((task) => {
  console.log(task.title);
  console.log(task.status);
});

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

type TaskRecord = EntityRecord["Task"];

// Query is type-checked against Task fields
const activeTasks = await base44.entities.Task.filter({
  status: "active",
  priority: "high",
});

Function types

Function names are typed for autocomplete when invoking functions:

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

Function parameter types are not generated. Refer to your function implementation for expected parameters.

Agent types

Agent names are typed for autocomplete when working with conversations:

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

Connector types

Connector integration type names are typed for autocomplete when retrieving connections:

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

The connectors module is only available in service role mode (backend environments).

Generate types

To generate or update your types file, run the types generate command:

base44 types generate

Re-run types generate whenever you modify entities, add functions, or change agents to keep types up to date.

Get Started

SDK Reference

How it works

Entity types

Function types

Agent types

Connector types

Generate types

See also

​How it works

​Entity types

​Function types

​Agent types

​Connector types

​Generate types

​See also

How it works

Entity types

Function types

Agent types

Connector types

Generate types

See also