Improve application ast (#17016)

# Summary

- Introduces a new, flexible folder structure for Twenty SDK
applications using file suffix-based entity detection
- Adds defineApp, defineFunction, defineObject, and defineRole helper
functions with built-in validation
- Refactors manifest loading to use jiti runtime evaluation for
TypeScript config files
- Separates validation logic into dedicated module with comprehensive
error reporting

  # New Application Folder Structure

Applications now use a convention-over-configuration approach where
entities are detected by their file suffix, allowing flexible
organization within the src/app/ folder.

  # Required Structure

    my-app/
    ├── package.json
    ├── yarn.lock
    └── src/
        ├── app/
│ └── application.config.ts # Required - main application configuration
└── utils/ # Optional - handler implementations & utilities

  # Entity Detection by File Suffix

    - *.object.ts - Custom object definitions
    - *.function.ts - Serverless function definitions
    - *.role.ts - Role definitions

  # Supported Folder Organizations

  ## Traditional (by type):
    src/app/
    ├── application.config.ts
    ├── objects/
    │   └── postCard.object.ts
    ├── functions/
    │   └── createPostCard.function.ts
    └── roles/
        └── admin.role.ts

  ## Feature-based:
    src/app/
    ├── application.config.ts
    └── post-card/
        ├── postCard.object.ts
        ├── createPostCard.function.ts
        └── postCardAdmin.role.ts

  ## Flat:
    src/app/
    ├── application.config.ts
    ├── postCard.object.ts
    ├── createPostCard.function.ts
    └── admin.role.ts

  # New Helper Functions

  ## defineApp(config)

    import { defineApp } from 'twenty-sdk';

    export default defineApp({
      universalIdentifier: '4ec0391d-...',
      displayName: 'My App',
      description: 'App description',
      icon: 'IconWorld',
    });

  ## defineObject(config)

    import { defineObject, FieldType } from 'twenty-sdk';

    export default defineObject({
      universalIdentifier: '54b589ca-...',
      nameSingular: 'postCard',
      namePlural: 'postCards',
      labelSingular: 'Post Card',
      labelPlural: 'Post Cards',
      icon: 'IconMail',
      fields: [
        {
          universalIdentifier: '58a0a314-...',
          type: FieldType.TEXT,
          name: 'content',
          label: 'Content',
        },
      ],
    });

  ## defineFunction(config)

    import { defineFunction } from 'twenty-sdk';
    import { myHandler } from '../utils/my-handler';

    export default defineFunction({
      universalIdentifier: 'e56d363b-...',
      name: 'My Function',
      handler: myHandler,
      triggers: [
        {
          universalIdentifier: 'c9f84c8d-...',
          type: 'route',
          path: '/my-route',
          httpMethod: 'POST',
        },
      ],
    });

  ## defineRole(config)

    import { defineRole, PermissionFlag } from 'twenty-sdk';

    export default defineRole({
      universalIdentifier: 'b648f87b-...',
      label: 'App User',
      objectPermissions: [
        {
          objectNameSingular: 'postCard',
          canReadObjectRecords: true,
        },
      ],
      permissionFlags: [PermissionFlag.UPLOAD_FILE],
    });

  # Test plan

    - Verify npx twenty app sync works with new folder structure
    - Verify npx twenty app dev works with new folder structure
    - Verify validation errors display correctly for invalid configs
- Verify all three folder organization styles work (traditional,
feature-based, flat)
    - Run existing E2E tests to ensure backward compatibility

packages/twenty-sdk/src/cli/utils/get-function-base-file.ts

@@ -9,28 +9,51 @@ export const getFunctionBaseFile = ({
   universalIdentifier?: string;
 }) => {
   const kebabCaseName = kebabCase(name);
+  const triggerUniversalIdentifier = v4();
 
-  return `import { type FunctionConfig } from 'twenty-sdk';
+  return `import { defineFunction } from 'twenty-sdk';
 
-export const main = async (params: {
+// Handler function - rename and implement your logic
+export const handler = async (params: {
   a: string;
   b: number;
 }): Promise<{ message: string }> => {
   const { a, b } = params;
 
-  // Rename the parameters and code below with your own logic
-  // This is just an example
-  const message = \`Hello, input: $\{a} and $\{b}\`;
+  // Replace with your own logic
+  const message = \`Hello, input: \${a} and \${b}\`;
 
   return { message };
 };
 
-export const config: FunctionConfig = {
+export default defineFunction({
   universalIdentifier: '${universalIdentifier}',
   name: '${kebabCaseName}',
+  description: 'Add a description for your function',
   timeoutSeconds: 5,
-  triggers: [],
-};
-
+  handler,
+  triggers: [
+    // Add your triggers here
+    // Route trigger example:
+    // {
+    //   universalIdentifier: '${triggerUniversalIdentifier}',
+    //   type: 'route',
+    //   path: '/${kebabCaseName}',
+    //   httpMethod: 'POST',
+    // },
+    // Cron trigger example:
+    // {
+    //   universalIdentifier: '...',
+    //   type: 'cron',
+    //   pattern: '0 0 * * *', // Daily at midnight
+    // },
+    // Database event trigger example:
+    // {
+    //   universalIdentifier: '...',
+    //   type: 'databaseEvent',
+    //   eventName: 'objectName.created',
+    // },
+  ],
+});
 `;
 };