Syncable Entity Integration
Contributing to the Twenty codebase itself (twentyhq/twenty server internals), not for...
Install
npx skills add twentyhq/twenty --skill syncable-entity-integration -g -a claude-code -y- Repository
- twentyhq/twenty60.3k
- Category
- Business
- Updated
- 3d ago
- License
- See repository
- Context cost
- Mediumabout 2,756 tokens
- Runs scripts
- No, instructions only
What it does
Contributing to the Twenty codebase itself (twentyhq/twenty server internals), not for building apps on top of Twenty. Wire syncable entity services into NestJS modules, create service layer and resolvers for Twenty entities. Use when registering builders, validators, and action handlers in modules, creating business services, or exposing entities via GraphQL API with proper exception handling.
Syncable Entity: Integration (Step 5/6)
Purpose: Wire everything together, register in modules, create services and resolvers.
When to use: After completing Steps 1-4 (all previous steps). Required before testing.
Quick Start
This step:
- Registers services in 3 NestJS modules
- Creates service layer (returns flat entities)
- Creates resolver layer (converts flat → DTO)
- Uses exception interceptor for GraphQL
Key principle: Services return flat entities, resolvers transpile flat → DTO.
Step 1: Register in Builder Module
File: src/engine/workspace-manager/workspace-migration/workspace-migration-builder/workspace-migration-builder.module.ts
import { WorkspaceMigrationMyEntityActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/my-entity/workspace-migration-my-entity-actions-builder.service';
@Module({
imports: [
// ... existing imports
],
providers: [
// ... existing providers
WorkspaceMigrationMyEntityActionsBuilderService,
],
exports: [
// ... existing exports
WorkspaceMigrationMyEntityActionsBuilderService,
],
})
export class WorkspaceMigrationBuilderModule {}
Important: Add to both providers AND exports (builder needs to be exported for orchestrator).
Step 2: Register in Validators Module
File: src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/workspace-migration-builder-validators.module.ts
import { FlatMyEntityValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-my-entity-validator.service';
