Teable AI-Native Data Management Platform

The adapter-db-postgres-pg package provides the database adapter layer for Teable v2 using the Kysely query builder with a Postgres dialect, powered by the pg driver. It is responsible for:

• Providing the Kysely Postgres dialect.
• Re-exporting shared Postgres DB tokens, configuration schemas, and the UnitOfWork implementation from the shared adapter package.
• Exposing Dependency Injection (DI) helpers to register the database into application containers.

The package is organized into the following structure:

• src/createDb.ts: Contains the factory for creating the Kysely instance and the KyselyPGlite dialect.
• src/di/register.ts: Handles Dependency Injection (DI) registration for the PGlite dialect.
• src/di/: Contains DI registration helpers.
• src/index.ts: The public entry point for the package exports.

The @teable/v2-utils package provides reusable utility helpers designed for formatting and convenience. Its primary purpose is to provide utilities that depend on @teable/v2-core while remaining decoupled from the core domain logic.

Key functionality includes:

• Table Rendering: Using printTable.ts to render domain tables and raw record payloads into human-readable ASCII tables, which is useful for CLI tools or logging.

Plugins are extensions that integrate into specific positions within the Teable application. Official plugins are managed within a single Next.js project located in the plugins directory, which facilitates code sharing and maintenance.

Plugins can be integrated into two supported positions defined by the PluginPosition enum:

export enum PluginPosition {
  Dashboard = 'dashboard',
  View = 'view',
}

Computed fields are filtered out at multiple layers to prevent invalid manual updates:

1. Domain Layer: table.getEditableFields() excludes computed fields from the initial set.
2. Infrastructure Layer: A secondary check is performed using field.computed().toBoolean().
3. Visitor Layer: The visitor returns an empty result for formula fields to ensure no database columns are targeted for these fields.

// Visitor implementation for formula fields
visitFormulaField(): FieldInsertResult {
  return { columnValues: {}, queryExecutors: [] };
}

The adapter-db-postgres-postgresjs package provides a Kysely dialect backed by the postgres driver. Its primary responsibilities are:

1. Providing the Kysely Postgres.js dialect using the postgres library.
2. Registering a Kysely instance into the shared Postgres DB tokens.
3. Re-exporting shared Postgres tokens, configuration, and UnitOfWork from the shared adapter package.

Key components include:

• src/createDb.ts: A factory for creating the Kysely instance with the PostgresJSDialect.
• src/di/register.ts: Handles Dependency Injection (DI) registration for the postgresjs dialect.
• src/index.ts: The public entry point for the package exports.

The application layer in Teable is responsible for orchestrating domain behavior and coordinating ports. It manages cross-aggregate workflows, transactions, and event publishing boundaries.

Crucial Rule: The application layer must not contain domain rules. All business logic and domain rules must be delegated to domain services, entities, or visitors. If you are implementing logic that determines how a specific entity behaves, it belongs in the domain layer; if you are implementing logic that coordinates multiple entities or handles a high-level workflow, it belongs in the application layer.

The domain/formula package is responsible for the core logic surrounding formula parsing and type inference. It provides the necessary infrastructure for domain value objects to understand the structure and expected types of formulas without actually executing them (evaluation).

Key responsibilities include:

• Parsing and Type Inference: Providing helpers to determine the types of values within a formula expression.
• Function Registry Metadata: Maintaining metadata for registered functions to enable return type inference based on input parameters (this is metadata-only and does not perform evaluation).