The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
Expose programmatic SDK build and typecheck APIs (#26824)
Weiko4b26be676df2
diff --git a/packages/twenty-sdk/README.md b/packages/twenty-sdk/README.mdindex a0651b8d295..256884af9a0 100644--- a/packages/twenty-sdk/README.md+++ b/packages/twenty-sdk/README.md@@ -34,6 +34,7 @@ Full documentation is available at **[docs.twenty.com/developers/extend/apps](htGuides in this repository:+- [Programmatic application builds](./docs/build.md), local builds and typechecking for scripts and integrations- [Logic function inputs](./docs/logic-function-inputs.md) — input schema inference, record-typed inputs, and the id contract## Manual installationdiff --git a/packages/twenty-sdk/docs/build.md b/packages/twenty-sdk/docs/build.mdnew file mode 100644index 00000000000..d58c4a4662d--- /dev/null+++ b/packages/twenty-sdk/docs/build.md@@ -0,0 +1,71 @@+# Programmatic application builds++`twenty-sdk/build` exposes local build and typecheck operations for scripts, CI jobs, and integrations. It requires an app project and its installed dependencies, but no workspace connection or separate CLI package. The SDK does not manage credentials, read CLI configuration, contact a workspace, prompt, print results, or exit the process through this entry point. Application source is trusted executable code and can have its own side effects; callers that need process isolation should use a worker or child process.++Read `twenty-sdk/build/descriptor.json` before importing the SDK. It is generated from the package version and Node requirement at build time. Its protocol version is independent of SDK semver and server compatibility. Importing the build entry does not load TypeScript or esbuild.++```ts+import { buildAppSnapshot, releaseAppSnapshot } from 'twenty-sdk/build';++const result = await buildAppSnapshot({ appPath: process.cwd() });++if (!result.success) {+ console.error(result.diagnostics);+ throw new Error(result.error.message);+}++try {+ console.log(result.data.manifest);+ console.table(result.data.files);+} finally {+ const release = await releaseAppSnapshot({+ buildId: result.data.buildId,+ });++ if (!release.success) {+ throw new Error(release.error.message);+ }+}+```++Save the example as `build.mjs` in the app project and run it with Node. `typecheckApp({ appPath: process.cwd() })` checks the project without building artifacts. Public types, including `BuildSnapshot`, `BuildResult`, and `BuildDiagnostic`, are exported from `twenty-sdk/build`; consumers do not need the private `twenty-shared` package.++Protocol 1 advertises `build`, `typecheck`, and `releaseSnapshot`. Check the descriptor's capabilities rather than inferring them from the SDK version. Operations are loaded lazily, so importing the entry or reading `BUILD_DESCRIPTOR` does not load TypeScript or esbuild.++The import path and named exports `buildAppSnapshot`, `typecheckApp`, `releaseAppSnapshot`, and `BUILD_DESCRIPTOR` are public SDK API for local application builds and typechecking. A protocol version bump does not make renaming those exports backward-compatible; changes must preserve existing imports or follow a breaking SDK release. Workspace authentication, uploads, and synchronization remain outside this entry point.++## Results and diagnostics++Operations return `{ success: true, data, diagnostics }` or `{ success: false, error: { code, message }, diagnostics }`. Typechecking succeeds with `data: null` and emits no files. Missing or invalid TypeScript configuration is a failure, including diagnostics without a source location.++Diagnostics have `severity`, `code`, and `message`, with optional project-relative `file` and one-based `line` and `column`. Codes include TypeScript codes such as `TS2322`. Operation error codes are `INVALID_APP_PATH`, `MANIFEST_BUILD_FAILED`, `BUILD_FAILED`, `TYPECHECK_FAILED`, `CANCELLED`, `SNAPSHOT_NOT_FOUND`, and `SNAPSHOT_RELEASE_FAILED`. Callers decide how to display results and which exit codes to use.++Both new operations fail on TypeScript configuration and project-reference errors, including errors without a source location. The legacy builder's text parser silently ignored some of these failures; successful legacy builds do not establish that a project passes typechecking. Before migrating, run the new typecheck operation and fix its diagnostics. For `TS6305`, build the referenced TypeScript projects first, or correct references that should not be part of the app compilation. Regenerate any app-specific client types against the intended workspace and SDK. The SDK never builds referenced projects or emits declarations implicitly, so its declared file writes remain accurate.++Build and typecheck accept an optional `AbortSignal`. Cancellation is checked between asynchronous stages; synchronous TypeScript checking cannot be interrupted in-process. Use a worker or child process when immediate cancellation or protection against app code calling `process.exit` is required. This is process isolation, not a sandbox for untrusted code.++## Build snapshots++A successful build returns:++- `buildId`, unique for the build, and `directory`, an absolute directory containing stable artifact bytes.+- `manifestFormat: "twenty-application"` and the opaque `manifest`. This format name identifies the existing server manifest, which has no standalone numeric schema version. The server still validates compatibility.+- `application: { universalIdentifier, name, displayName }`, with `name` taken from the app package.+- `files`, the complete uploadable artifact set, sorted by path. Each entry has a snapshot-relative POSIX `path`, logical app-relative `sourcePath`, `role`, byte `size`, and `sha256`. Read artifact bytes from `directory` and `path`.+- `contentHash`, SHA-256 of the UTF-8 JSON encoding of the sorted `{ path, role, sha256 }` entries, a newline, then the exact `manifest.json` bytes. Compare within a compatible SDK/build environment; this is not a server-approved plan digest.++Roles are the server's upload folder values: `built-logic-function`, `built-front-component`, `source`, `dependencies`, and `public-asset`. Sources, dependency files, and generated assets are included every time, even when unchanged. Source maps, README, and `manifest.json` may also exist in the directory; they are not extra upload targets. Existing manifest checksum algorithms remain unchanged; artifact SHA-256 is a separate transport integrity contract.++`sourcePath` identifies an artifact's origin: compiled files point to their TypeScript source, the shared dependencies bundle points to `package.json`, and generated assets such as the cover may not exist in the app directory. It is not a path to the artifact's bytes.++Each build allocates a new `.twenty/snapshots/build-*/` directory inside the existing app directory, with artifacts in `files/` and owner information in `lease.json`. Cleanup removes only that new per-build directory, never the app directory, pre-existing snapshots, or `.twenty/output`. Static files are copied as bytes without modifying source symlinks or their targets, so changing a symlink target cannot mutate a retained snapshot.++Keep the owning SDK instance alive while consuming a snapshot. `releaseSnapshot` deletes the entire directory and its lease, not just the in-memory handle. Release in a `finally` block after consuming or uploading the artifacts. Unknown or foreign build IDs fail without deleting files. Never release a snapshot while another operation still uses its files.++Failed builds clean up their own directory. A killed process can leave an orphan. Protocol 1 does not automatically prune other processes' directories. To remove crash leftovers manually, stop all SDK build processes using that app first, then remove its `.twenty/snapshots` directory. This keeps active snapshots safe from PID reuse and cleanup races.++## Existing SDK commands++The existing `twenty` binary and `twenty-sdk/cli` exports remain available. This API adds no executable, changes no command names, and requires no command migration.++Existing builds retain their output directory, symlink-copy behavior, typecheck implementation and error formatting. Snapshot isolation and the stricter configuration checks above apply to the new build operations.diff --git a/packages/twenty-sdk/package.json b/packages/twenty-sdk/package.jsonindex 61bfc6f0d62..97fb84363dd 100644--- a/packages/twenty-sdk/package.json+++ b/packages/twenty-sdk/package.json@@ -9,7 +9,8 @@"dist","README.md","CHANGELOG.md",- "package.json"+ "package.json",+ "docs/build.md"],"scripts": {"build": "npx rimraf dist && npx vite build"@@ -62,7 +63,13 @@"types": "./dist/front-component-renderer/build/index.d.ts","import": "./dist/front-component-renderer/build.mjs","require": "./dist/front-component-renderer/build.cjs"- }+ },+ "./build": {+ "types": "./dist/build/index.d.ts",+ "import": "./dist/build.mjs",+ "require": "./dist/build.cjs"+ },+ "./build/descriptor.json": "./dist/build/descriptor.json"},"license": "MIT","dependencies": {@@ -136,6 +143,9 @@],"front-component-renderer/build": ["dist/front-component-renderer/build/index.d.ts"+ ],+ "build": [+ "dist/build/index.d.ts"]}}diff --git a/packages/twenty-sdk/rollup.config.sdk-dts.mjs b/packages/twenty-sdk/rollup.config.sdk-dts.mjsindex 1ab3f7500a3..d30f74ce425 100644--- a/packages/twenty-sdk/rollup.config.sdk-dts.mjs+++ b/packages/twenty-sdk/rollup.config.sdk-dts.mjs@@ -18,6 +18,12 @@ const plugins = [];export default [+ {+ input: 'src/application-build/index.ts',+ output: { file: 'dist/build/index.d.ts', format: 'es' },+ external,+ plugins,+ },{input: 'src/sdk/define/index.ts',output: { file: 'dist/define/index.d.ts', format: 'es' },diff --git a/packages/twenty-sdk/src/application-build/__tests__/build-snapshot-failure.spec.ts b/packages/twenty-sdk/src/application-build/__tests__/build-snapshot-failure.spec.tsnew file mode 100644index 00000000000..d0f6de1669a--- /dev/null+++ b/packages/twenty-sdk/src/application-build/__tests__/build-snapshot-failure.spec.ts@@ -0,0 +1,84 @@+import {+ mkdir,+ mkdtemp,+ readFile,+ readdir,+ rm,+ writeFile,+} from 'node:fs/promises';+import { tmpdir } from 'node:os';+import { dirname, join } from 'node:path';+import { type Manifest } from 'twenty-shared/application';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++import { compileApplication } from '@/cli/utilities/build/common/compile-application';+import { buildSnapshot } from '@/application-build/build-snapshot';++vi.mock('@/cli/utilities/build/common/compile-application', () => ({+ compileApplication: vi.fn(),+}));++describe('build snapshot failure diagnostics', () => {+ let appPath: string;++ beforeEach(async () => {+ appPath = await mkdtemp(join(tmpdir(), 'tooling-failure-'));+ });++ afterEach(async () => {+ vi.resetAllMocks();+ await rm(appPath, { recursive: true, force: true });+ });++ it('retains warnings and existing files when artifact collection fails', async () => {+ const existingPaths = [+ join(appPath, 'keep.txt'),+ join(appPath, '.twenty', 'output', 'keep.txt'),+ join(appPath, '.twenty', 'snapshots', 'build-existing', 'keep.txt'),+ ];++ for (const filePath of existingPaths) {+ await mkdir(dirname(filePath), { recursive: true });+ await writeFile(filePath, 'existing content');+ }++ vi.mocked(compileApplication).mockImplementation(async ({ outputDir }) => {+ const directory = join(appPath, outputDir!);++ await mkdir(directory, { recursive: true });+ await writeFile(join(directory, 'manifest.json'), '{}');+ await writeFile(join(directory, 'package.json'), '{}');++ return {+ success: true,+ data: { manifest: {} as Manifest, builtFileInfos: new Map() },+ diagnostics: [+ {+ severity: 'warning',+ code: 'BUILD_WARNING',+ message: 'An optional translation was skipped',+ },+ ],+ };+ });++ expect(await buildSnapshot({ appPath })).toMatchObject({+ success: false,+ error: { code: 'BUILD_FAILED' },+ diagnostics: [+ {+ severity: 'warning',+ code: 'BUILD_WARNING',+ message: 'An optional translation was skipped',+ },+ ],+ });+ expect(await readdir(join(appPath, '.twenty', 'snapshots'))).toEqual([+ 'build-existing',+ ]);++ for (const filePath of existingPaths) {+ expect(await readFile(filePath, 'utf8')).toBe('existing content');+ }+ });+});diff --git a/packages/twenty-sdk/src/application-build/__tests__/build-snapshot.spec.ts b/packages/twenty-sdk/src/application-build/__tests__/build-snapshot.spec.tsnew file mode 100644index 00000000000..32c02e82271--- /dev/null+++ b/packages/twenty-sdk/src/application-build/__tests__/build-snapshot.spec.ts@@ -0,0 +1,307 @@+import { createHash } from 'node:crypto';+import {+ cp,+ lstat,+ mkdir,+ mkdtemp,+ readFile,+ readdir,+ rm,+ symlink,+ writeFile,+} from 'node:fs/promises';+import { tmpdir } from 'node:os';+import { basename, dirname, join, resolve } from 'node:path';+import { type Manifest } from 'twenty-shared/application';+import { type BuildSnapshot } from '@/application-build/types';+import {+ afterAll,+ afterEach,+ beforeAll,+ describe,+ expect,+ it,+ vi,+} from 'vitest';++import { MINIMAL_APP_PATH } from '@/cli/__tests__/apps/fixture-paths';+import { appBuild } from '@/cli/operations/build';+import { pathExists } from '@/cli/utilities/file/fs-utils';+import { buildAppSnapshot, releaseAppSnapshot } from '@/application-build';++describe('buildAppSnapshot snapshots', () => {+ let appPath: string;+ let first: BuildSnapshot;+ let second: BuildSnapshot;+ let originalTsconfig: string;+ const snapshots: BuildSnapshot[] = [];++ const build = async () => {+ const result = await buildAppSnapshot({ appPath });++ if (!result.success) {+ throw new Error(JSON.stringify(result));+ }++ snapshots.push(result.data);++ return result.data;+ };++ beforeAll(async () => {+ appPath = await mkdtemp(join(tmpdir(), 'twenty-tooling-build-'));+ await cp(MINIMAL_APP_PATH, appPath, {+ recursive: true,+ filter: (source) =>+ !['node_modules', '.twenty'].includes(basename(source)),+ });+ await symlink(+ resolve(MINIMAL_APP_PATH, '../../../../node_modules'),+ join(appPath, 'node_modules'),+ 'junction',+ );+ originalTsconfig = await readFile(join(appPath, 'tsconfig.json'), 'utf8');+ await mkdir(join(appPath, 'public'), { recursive: true });+ for (const fileName of ['z-last.txt', 'ä-unicode.txt', 'B-first.txt']) {+ await writeFile(join(appPath, 'public', fileName), fileName);+ }+ await writeFile(join(appPath, 'asset-source.txt'), 'original asset');+ await symlink(+ join(appPath, 'asset-source.txt'),+ join(appPath, 'public', 'asset.txt'),+ 'file',+ );+ vi.stubGlobal(+ 'fetch',+ vi.fn(() => {+ throw new Error('Local tooling must not make network requests');+ }),+ );+ [first, second] = await Promise.all([build(), build()]);+ }, 120000);++ afterEach(async () => {+ await writeFile(join(appPath, 'asset-source.txt'), 'original asset');+ await writeFile(join(appPath, 'tsconfig.json'), originalTsconfig);+ await rm(join(appPath, 'type-error.ts'), { force: true });+ await rm(join(appPath, 'referenced'), { recursive: true, force: true });+ await rm(join(appPath, '.twenty', 'output'), {+ recursive: true,+ force: true,+ });+ });++ afterAll(async () => {+ for (const snapshot of snapshots) {+ await releaseAppSnapshot({ buildId: snapshot.buildId });+ }++ vi.unstubAllGlobals();+ await rm(appPath, { recursive: true, force: true });+ });++ it('returns complete upload roles with checksums matching the snapshot bytes', async () => {+ expect([...new Set(first.files.map((file) => file.role))].sort()).toEqual([+ 'built-front-component',+ 'built-logic-function',+ 'dependencies',+ 'public-asset',+ 'source',+ ]);++ for (const artifact of first.files) {+ const bytes = await readFile(join(first.directory, artifact.path));++ expect(artifact.size).toBe(bytes.length);+ expect(artifact.sha256).toBe(+ createHash('sha256').update(bytes).digest('hex'),+ );+ }++ const manifest = JSON.parse(+ await readFile(join(first.directory, 'manifest.json'), 'utf8'),+ ) as Manifest;++ expect(first.manifest).toEqual(manifest);+ expect(manifest.publicAssets).toEqual(+ expect.arrayContaining([+ expect.objectContaining({+ checksum: createHash('md5').update('original asset').digest('hex'),+ }),+ ]),+ );+ expect(first.application).toMatchObject({ name: 'minimal-app' });+ });++ it('keeps concurrent builds independent and hashes unchanged content identically', () => {+ expect(first.buildId).not.toBe(second.buildId);+ expect(first.directory).not.toBe(second.directory);+ expect(first.contentHash).toBe(second.contentHash);+ expect(first.files).toEqual(second.files);+ });++ it('orders artifact paths independently of locale collation', () => {+ expect(+ first.files+ .map((file) => file.path)+ .filter((filePath) => filePath.startsWith('public/')),+ ).toEqual([+ 'public/B-first.txt',+ 'public/asset.txt',+ 'public/z-last.txt',+ 'public/ä-unicode.txt',+ ]);+ });++ it('preserves the existing build output and symlink behavior beside snapshots', async () => {+ const result = await appBuild({ appPath });++ expect(result).toMatchObject({+ success: true,+ data: { outputDir: join(appPath, '.twenty', 'output') },+ });+ expect(+ (+ await lstat(join(appPath, '.twenty', 'output', 'public', 'asset.txt'))+ ).isSymbolicLink(),+ ).toBe(true);++ for (const artifact of first.files) {+ expect(+ await readFile(join(appPath, '.twenty', 'output', artifact.path)),+ ).toEqual(await readFile(join(first.directory, artifact.path)));+ }++ expect(+ await readFile(join(appPath, '.twenty', 'output', 'manifest.json')),+ ).toEqual(await readFile(join(first.directory, 'manifest.json')));+ }, 120000);++ it('retains copied bytes after source changes and releases only its own snapshot', async () => {+ const retainedBytes = await Promise.all(+ first.files.map((file) => readFile(join(first.directory, file.path))),+ );++ await writeFile(join(appPath, 'asset-source.txt'), 'changed asset');+ const changed = await build();++ expect(changed.contentHash).not.toBe(first.contentHash);+ expect(+ await Promise.all(+ first.files.map((file) => readFile(join(first.directory, file.path))),+ ),+ ).toEqual(retainedBytes);+ expect(await releaseAppSnapshot({ buildId: changed.buildId })).toEqual({+ success: true,+ data: null,+ diagnostics: [],+ });+ expect(await pathExists(dirname(changed.directory))).toBe(false);+ expect(await pathExists(first.directory)).toBe(true);+ expect(await pathExists(second.directory)).toBe(true);+ expect(+ await releaseAppSnapshot({ buildId: changed.buildId }),+ ).toMatchObject({ success: false, error: { code: 'SNAPSHOT_NOT_FOUND' } });+ expect(+ await releaseAppSnapshot({ buildId: 'unowned-build' }),+ ).toMatchObject({ success: false, error: { code: 'SNAPSHOT_NOT_FOUND' } });+ expect(await pathExists(first.directory)).toBe(true);+ }, 120000);++ it('removes only the failed build after a compiler error', async () => {+ const snapshotsDirectory = join(appPath, '.twenty', 'snapshots');+ const directoriesBefore = (await readdir(snapshotsDirectory)).sort();++ await writeFile(+ join(appPath, 'type-error.ts'),+ 'export const broken: number = "bad";',+ );++ expect(await buildAppSnapshot({ appPath })).toMatchObject({+ success: false,+ error: { code: 'TYPECHECK_FAILED' },+ diagnostics: expect.arrayContaining([+ expect.objectContaining({ code: 'TS2322' }),+ ]),+ });+ expect((await readdir(snapshotsDirectory)).sort()).toEqual(+ directoriesBefore,+ );+ expect(await pathExists(first.directory)).toBe(true);+ }, 120000);++ it('preserves existing app files and output folders when releasing a snapshot', async () => {+ const existingPaths = [+ join(appPath, 'keep.txt'),+ join(appPath, '.twenty', 'output', 'keep.txt'),+ join(appPath, '.twenty', 'snapshots', 'build-existing', 'keep.txt'),+ ];++ for (const filePath of existingPaths) {+ await mkdir(dirname(filePath), { recursive: true });+ await writeFile(filePath, 'existing content');+ }++ const snapshot = await build();++ expect(await releaseAppSnapshot({ buildId: snapshot.buildId })).toEqual({+ success: true,+ data: null,+ diagnostics: [],+ });+ expect(await pathExists(dirname(snapshot.directory))).toBe(false);++ for (const filePath of existingPaths) {+ expect(await readFile(filePath, 'utf8')).toBe('existing content');+ }+ }, 120000);++ it('does not create output for a cancelled build', async () => {+ const snapshotsDirectory = join(appPath, '.twenty', 'snapshots');+ const directoriesBefore = (await readdir(snapshotsDirectory)).sort();++ expect(+ await buildAppSnapshot({ appPath, signal: AbortSignal.abort() }),+ ).toMatchObject({ success: false, error: { code: 'CANCELLED' } });+ expect((await readdir(snapshotsDirectory)).sort()).toEqual(+ directoriesBefore,+ );+ expect(await pathExists(join(appPath, '.twenty', 'output'))).toBe(false);+ });++ it('rejects unbuilt TypeScript references and cleans the incomplete snapshot', async () => {+ const snapshotsDirectory = join(appPath, '.twenty', 'snapshots');+ const directoriesBefore = (await readdir(snapshotsDirectory)).sort();++ await mkdir(join(appPath, 'referenced'));+ await writeFile(+ join(appPath, 'referenced', 'source.ts'),+ 'export const value = 1;',+ );+ await writeFile(+ join(appPath, 'referenced', 'tsconfig.json'),+ JSON.stringify({+ compilerOptions: { composite: true, outDir: 'dist', types: [] },+ files: ['source.ts'],+ }),+ );+ await writeFile(+ join(appPath, 'tsconfig.json'),+ JSON.stringify({+ ...JSON.parse(originalTsconfig),+ references: [{ path: './referenced' }],+ }),+ );++ expect(await buildAppSnapshot({ appPath })).toMatchObject({+ success: false,+ error: { code: 'TYPECHECK_FAILED' },+ diagnostics: expect.arrayContaining([+ expect.objectContaining({ severity: 'error', code: 'TS6305' }),+ ]),+ });+ expect((await readdir(snapshotsDirectory)).sort()).toEqual(+ directoriesBefore,+ );+ }, 120000);+});diff --git a/packages/twenty-sdk/src/application-build/__tests__/typecheck-application.spec.ts b/packages/twenty-sdk/src/application-build/__tests__/typecheck-application.spec.tsnew file mode 100644index 00000000000..04fc26c9734--- /dev/null+++ b/packages/twenty-sdk/src/application-build/__tests__/typecheck-application.spec.ts@@ -0,0 +1,138 @@+import { mkdir, mkdtemp, readdir, rm, writeFile } from 'node:fs/promises';+import { tmpdir } from 'node:os';+import { join } from 'node:path';+import { afterEach, beforeEach, describe, expect, it } from 'vitest';++import { typecheckApp } from '@/application-build';++describe('typecheckApp', () => {+ let appPath: string;++ beforeEach(async () => {+ appPath = await mkdtemp(join(tmpdir(), 'twenty-tooling-typecheck-'));+ await writeFile(+ join(appPath, 'tsconfig.json'),+ JSON.stringify({+ compilerOptions: { strict: true, types: [], declaration: true },+ files: ['example.ts'],+ }),+ );+ await writeFile(join(appPath, 'example.ts'), 'export const value = 1;');+ });++ afterEach(async () => {+ await rm(appPath, { recursive: true, force: true });+ });++ it('checks valid code without emitting JavaScript or declarations', async () => {+ expect(await typecheckApp({ appPath })).toEqual({+ success: true,+ data: null,+ diagnostics: [],+ });+ expect((await readdir(appPath)).sort()).toEqual([+ 'example.ts',+ 'tsconfig.json',+ ]);+ });++ it('reports compiler errors with project-relative, one-based locations', async () => {+ await writeFile(+ join(appPath, 'example.ts'),+ 'export const broken: number = "bad";',+ );++ expect(await typecheckApp({ appPath })).toMatchObject({+ success: false,+ error: { code: 'TYPECHECK_FAILED' },+ diagnostics: [+ {+ severity: 'error',+ code: 'TS2322',+ file: 'example.ts',+ line: 1,+ column: 14,+ },+ ],+ });+ });++ it('fails when tsconfig.json is missing', async () => {+ await rm(join(appPath, 'tsconfig.json'));++ expect(await typecheckApp({ appPath })).toMatchObject({+ success: false,+ error: { code: 'TYPECHECK_FAILED' },+ diagnostics: [{ severity: 'error', code: 'TS5083' }],+ });+ });++ it('fails on invalid compiler options', async () => {+ await writeFile(+ join(appPath, 'tsconfig.json'),+ JSON.stringify({ compilerOptions: { target: 'invalid-target' } }),+ );++ expect(await typecheckApp({ appPath })).toMatchObject({+ success: false,+ error: { code: 'TYPECHECK_FAILED' },+ diagnostics: expect.arrayContaining([+ expect.objectContaining({ severity: 'error', code: 'TS6046' }),+ ]),+ });+ });++ it('fails on unbuilt project references even without a source location', async () => {+ await mkdir(join(appPath, 'referenced'));+ await writeFile(+ join(appPath, 'referenced', 'source.ts'),+ 'export const value = 1;',+ );+ await writeFile(+ join(appPath, 'referenced', 'tsconfig.json'),+ JSON.stringify({+ compilerOptions: { composite: true, outDir: 'dist', types: [] },+ files: ['source.ts'],+ }),+ );+ await writeFile(+ join(appPath, 'tsconfig.json'),+ JSON.stringify({+ compilerOptions: { types: [] },+ files: ['referenced/source.ts'],+ references: [{ path: './referenced' }],+ }),+ );++ const result = await typecheckApp({ appPath });++ expect(result).toMatchObject({+ success: false,+ error: { code: 'TYPECHECK_FAILED' },+ diagnostics: expect.arrayContaining([+ expect.objectContaining({ severity: 'error', code: 'TS6305' }),+ ]),+ });+ expect(+ result.diagnostics.find((diagnostic) => diagnostic.code === 'TS6305')+ ?.file,+ ).toBeUndefined();+ expect((await readdir(join(appPath, 'referenced'))).sort()).toEqual([+ 'source.ts',+ 'tsconfig.json',+ ]);+ });++ it('returns a structured cancellation before checking', async () => {+ expect(+ await typecheckApp({ appPath, signal: AbortSignal.abort() }),+ ).toMatchObject({ success: false, error: { code: 'CANCELLED' } });+ });++ it('rejects relative application paths', async () => {+ expect(await typecheckApp({ appPath: 'relative-app' })).toMatchObject({+ success: false,+ error: { code: 'INVALID_APP_PATH' },+ });+ });+});diff --git a/packages/twenty-sdk/src/application-build/build-descriptor.ts b/packages/twenty-sdk/src/application-build/build-descriptor.tsnew file mode 100644index 00000000000..532ac7dea19--- /dev/null+++ b/packages/twenty-sdk/src/application-build/build-descriptor.ts@@ -0,0 +1,15 @@+import { type BuildDescriptor } from '@/application-build/types';++import packageJson from '../../package.json';++export const BUILD_DESCRIPTOR: BuildDescriptor = {+ protocolVersion: 1,+ sdkVersion: packageJson.version,+ requiredNode: packageJson.engines.node,+ capabilities: ['build', 'typecheck', 'releaseSnapshot'],+ fileWrites: {+ build: ['.twenty/snapshots/**'],+ typecheck: [],+ releaseSnapshot: ['.twenty/snapshots/**'],+ },+};diff --git a/packages/twenty-sdk/src/application-build/build-snapshot.ts b/packages/twenty-sdk/src/application-build/build-snapshot.tsnew file mode 100644index 00000000000..a6505f8fb37--- /dev/null+++ b/packages/twenty-sdk/src/application-build/build-snapshot.ts@@ -0,0 +1,146 @@+import { randomUUID } from 'node:crypto';+import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';+import { join, relative } from 'node:path';+import { isDefined } from 'twenty-shared/utils';++import {+ type BuildSnapshot,+ type BuildDiagnostic,+ type BuildOperationOptions,+ type BuildResult,+} from '@/application-build/types';+import { compileApplication } from '@/cli/utilities/build/common/compile-application';+import { collectBuildSnapshot } from '@/application-build/collect-build-snapshot';+import { validateAppPath } from '@/application-build/validate-app-path';++const snapshotDirectories = new Map<string, string>();++export const buildSnapshot = async ({+ appPath,+ signal,+}: BuildOperationOptions): Promise<BuildResult<BuildSnapshot>> => {+ const validation = await validateAppPath(appPath);++ if (!validation.success) {+ return validation;+ }++ let snapshotDirectory: string | undefined;+ const diagnostics: BuildDiagnostic[] = [];+ const cleanupSnapshot = async () => {+ if (!isDefined(snapshotDirectory)) {+ return;+ }++ try {+ await rm(snapshotDirectory, { recursive: true, force: true });+ } catch (error) {+ diagnostics.push({+ severity: 'warning',+ code: 'SNAPSHOT_CLEANUP_FAILED',+ message: `Could not remove snapshot ${snapshotDirectory}: ${error instanceof Error ? error.message : String(error)}`,+ });+ }+ };++ try {+ signal?.throwIfAborted();+ const buildId = randomUUID();+ const snapshotsDirectory = join(appPath, '.twenty', 'snapshots');++ await mkdir(snapshotsDirectory, { recursive: true });+ snapshotDirectory = await mkdtemp(join(snapshotsDirectory, 'build-'));+ await writeFile(+ join(snapshotDirectory, 'lease.json'),+ JSON.stringify({+ buildId,+ pid: process.pid,+ createdAt: new Date().toISOString(),+ }),+ { flag: 'wx' },+ );++ const filesDirectory = join(snapshotDirectory, 'files');+ const result = await compileApplication({+ appPath,+ outputDir: relative(appPath, filesDirectory),+ dereferenceSymlinks: true,+ signal,+ });++ diagnostics.push(...result.diagnostics);++ if (!result.success) {+ await cleanupSnapshot();++ return {+ ...result,+ diagnostics,+ };+ }++ const snapshot = await collectBuildSnapshot({+ appPath,+ buildId,+ filesDirectory,+ manifest: result.data.manifest,+ builtFileInfos: result.data.builtFileInfos,+ signal,+ });++ signal?.throwIfAborted();+ snapshotDirectories.set(buildId, snapshotDirectory);++ return {+ success: true,+ data: snapshot,+ diagnostics,+ };+ } catch (error) {+ await cleanupSnapshot();++ return {+ success: false,+ error: {+ code: signal?.aborted ? 'CANCELLED' : 'BUILD_FAILED',+ message: error instanceof Error ? error.message : String(error),+ },+ diagnostics,+ };+ }+};++export const releaseSnapshot = async ({+ buildId,+}: {+ buildId: string;+}): Promise<BuildResult<null>> => {+ const snapshotDirectory = snapshotDirectories.get(buildId);++ if (!isDefined(snapshotDirectory)) {+ return {+ success: false,+ error: {+ code: 'SNAPSHOT_NOT_FOUND',+ message: 'This SDK instance does not hold the requested snapshot.',+ },+ diagnostics: [],+ };+ }++ try {+ await rm(snapshotDirectory, { recursive: true, force: true });+ snapshotDirectories.delete(buildId);++ return { success: true, data: null, diagnostics: [] };+ } catch (error) {+ return {+ success: false,+ error: {+ code: 'SNAPSHOT_RELEASE_FAILED',+ message: error instanceof Error ? error.message : String(error),+ },+ diagnostics: [],+ };+ }+};diff --git a/packages/twenty-sdk/src/application-build/collect-build-snapshot.ts b/packages/twenty-sdk/src/application-build/collect-build-snapshot.tsnew file mode 100644index 00000000000..cff9081b836--- /dev/null+++ b/packages/twenty-sdk/src/application-build/collect-build-snapshot.ts@@ -0,0 +1,116 @@+import { isNonEmptyString } from '@sniptt/guards';+import { createHash } from 'node:crypto';+import { createReadStream } from 'node:fs';+import { readFile } from 'node:fs/promises';+import { isAbsolute, join, relative, sep } from 'node:path';+import { type Manifest } from 'twenty-shared/application';+import { FileFolder } from 'twenty-shared/types';+import { isDefined } from 'twenty-shared/utils';++import { type BuiltFileInfo } from '@/cli/utilities/build/common/build-application';+import {+ type BuildArtifact,+ type BuildArtifactRole,+ type BuildSnapshot,+} from '@/application-build/types';++const ROLE_BY_FILE_FOLDER: Partial<Record<FileFolder, BuildArtifactRole>> = {+ [FileFolder.BuiltLogicFunction]: 'built-logic-function',+ [FileFolder.BuiltFrontComponent]: 'built-front-component',+ [FileFolder.Source]: 'source',+ [FileFolder.Dependencies]: 'dependencies',+ [FileFolder.PublicAsset]: 'public-asset',+};++export const collectBuildSnapshot = async ({+ appPath,+ buildId,+ filesDirectory,+ manifest,+ builtFileInfos,+ signal,+}: {+ appPath: string;+ buildId: string;+ filesDirectory: string;+ manifest: Manifest;+ builtFileInfos: Map<string, BuiltFileInfo>;+ signal?: AbortSignal;+}): Promise<BuildSnapshot> => {+ const files: BuildArtifact[] = [];++ for (const file of builtFileInfos.values()) {+ signal?.throwIfAborted();+ const absolutePath = join(appPath, file.builtPath);+ const filePath = relative(filesDirectory, absolutePath);+ const role = ROLE_BY_FILE_FOLDER[file.fileFolder];++ if (+ !isDefined(role) ||+ isAbsolute(filePath) ||+ filePath === '..' ||+ filePath.startsWith(`..${sep}`)+ ) {+ throw new Error(`Invalid snapshot artifact: ${file.builtPath}`);+ }++ const hash = createHash('sha256');+ let size = 0;++ for await (const chunk of createReadStream(absolutePath, { signal })) {+ hash.update(chunk);+ size += chunk.length;+ }++ files.push({+ path: filePath.split(sep).join('/'),+ sourcePath: file.sourcePath.split(sep).join('/'),+ role,+ size,+ sha256: hash.digest('hex'),+ });+ }++ const sortedFiles = files.sort((first, second) => {+ if (first.path < second.path) {+ return -1;+ }++ if (first.path > second.path) {+ return 1;+ }++ return 0;+ });+ const manifestBytes = await readFile(join(filesDirectory, 'manifest.json'));+ const contentHash = createHash('sha256')+ .update(+ JSON.stringify(+ sortedFiles.map(({ path, role, sha256 }) => ({ path, role, sha256 })),+ ),+ )+ .update('\n')+ .update(manifestBytes)+ .digest('hex');+ const packageJson: { name?: unknown } = JSON.parse(+ await readFile(join(filesDirectory, 'package.json'), 'utf8'),+ );++ if (!isNonEmptyString(packageJson.name)) {+ throw new Error('The app package.json must declare a name.');+ }++ return {+ buildId,+ directory: filesDirectory,+ contentHash,+ application: {+ universalIdentifier: manifest.application.universalIdentifier,+ name: packageJson.name,+ displayName: manifest.application.displayName,+ },+ manifestFormat: 'twenty-application',+ manifest,+ files: sortedFiles,+ };+};diff --git a/packages/twenty-sdk/src/application-build/index.ts b/packages/twenty-sdk/src/application-build/index.tsnew file mode 100644index 00000000000..070c343bcd2--- /dev/null+++ b/packages/twenty-sdk/src/application-build/index.ts@@ -0,0 +1,35 @@+import {+ type BuildOperationOptions,+ type BuildResult,+ type BuildSnapshot,+} from '@/application-build/types';++export { BUILD_DESCRIPTOR } from '@/application-build/build-descriptor';+export type {+ BuildArtifact,+ BuildArtifactRole,+ BuildSnapshot,+ BuildCapability,+ BuildDescriptor,+ BuildDiagnostic,+ BuildErrorCode,+ BuildOperationOptions,+ BuildResult,+} from '@/application-build/types';++export const buildAppSnapshot = async (+ options: BuildOperationOptions,+): Promise<BuildResult<BuildSnapshot>> =>+ (await import('@/application-build/build-snapshot')).buildSnapshot(options);++export const typecheckApp = async (+ options: BuildOperationOptions,+): Promise<BuildResult<null>> =>+ (+ await import('@/application-build/typecheck-application')+ ).typecheckApplication(options);++export const releaseAppSnapshot = async (options: {+ buildId: string;+}): Promise<BuildResult<null>> =>+ (await import('@/application-build/build-snapshot')).releaseSnapshot(options);diff --git a/packages/twenty-sdk/src/application-build/typecheck-application.ts b/packages/twenty-sdk/src/application-build/typecheck-application.tsnew file mode 100644index 00000000000..ea71ec1016c--- /dev/null+++ b/packages/twenty-sdk/src/application-build/typecheck-application.ts@@ -0,0 +1,110 @@+import { join, relative } from 'node:path';+import ts from 'typescript';+import { isDefined } from 'twenty-shared/utils';++import {+ type BuildDiagnostic,+ type BuildOperationOptions,+ type BuildResult,+} from '@/application-build/types';+import { validateAppPath } from '@/application-build/validate-app-path';++const toDiagnostic = ({+ diagnostic,+ appPath,+}: {+ diagnostic: ts.Diagnostic;+ appPath: string;+}): BuildDiagnostic => {+ const position =+ isDefined(diagnostic.file) && isDefined(diagnostic.start)+ ? diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start)+ : undefined;++ return {+ severity:+ diagnostic.category === ts.DiagnosticCategory.Warning+ ? 'warning'+ : 'error',+ code: `TS${diagnostic.code}`,+ message: ts.flattenDiagnosticMessageText(diagnostic.messageText, '\n'),+ ...(isDefined(diagnostic.file)+ ? { file: relative(appPath, diagnostic.file.fileName) }+ : {}),+ ...(isDefined(position)+ ? { line: position.line + 1, column: position.character + 1 }+ : {}),+ };+};++const collectCompilerDiagnostics = ({+ appPath,+}: {+ appPath: string;+}): readonly ts.Diagnostic[] => {+ const configPath = join(appPath, 'tsconfig.json');+ const config = ts.readConfigFile(configPath, ts.sys.readFile);++ if (isDefined(config.error)) {+ return [config.error];+ }++ const parsed = ts.parseJsonConfigFileContent(+ config.config,+ ts.sys,+ appPath,+ { noEmit: true },+ configPath,+ );++ if (parsed.errors.length > 0) {+ return parsed.errors;+ }++ const program = ts.createProgram({+ rootNames: parsed.fileNames,+ options: parsed.options,+ projectReferences: parsed.projectReferences,+ });++ return ts.getPreEmitDiagnostics(program);+};++export const typecheckApplication = async ({+ appPath,+ signal,+}: BuildOperationOptions): Promise<BuildResult<null>> => {+ const validation = await validateAppPath(appPath);++ if (!validation.success) {+ return validation;+ }++ try {+ signal?.throwIfAborted();+ const compilerDiagnostics = collectCompilerDiagnostics({ appPath });++ signal?.throwIfAborted();++ const diagnostics = compilerDiagnostics.map((diagnostic) =>+ toDiagnostic({ diagnostic, appPath }),+ );++ return diagnostics.some((diagnostic) => diagnostic.severity === 'error')+ ? {+ success: false,+ error: { code: 'TYPECHECK_FAILED', message: 'Typecheck failed.' },+ diagnostics,+ }+ : { success: true, data: null, diagnostics };+ } catch (error) {+ return {+ success: false,+ error: {+ code: signal?.aborted ? 'CANCELLED' : 'TYPECHECK_FAILED',+ message: error instanceof Error ? error.message : String(error),+ },+ diagnostics: [],+ };+ }+};diff --git a/packages/twenty-sdk/src/application-build/types.ts b/packages/twenty-sdk/src/application-build/types.tsnew file mode 100644index 00000000000..87799274050--- /dev/null+++ b/packages/twenty-sdk/src/application-build/types.ts@@ -0,0 +1,66 @@+export type BuildCapability = 'build' | 'typecheck' | 'releaseSnapshot';++export type BuildDescriptor = {+ protocolVersion: number;+ sdkVersion: string;+ requiredNode: string;+ capabilities: readonly BuildCapability[];+ fileWrites: Record<BuildCapability, readonly string[]>;+};++export type BuildDiagnostic = {+ severity: 'error' | 'warning';+ code: string;+ message: string;+ file?: string;+ line?: number;+ column?: number;+};++export type BuildErrorCode =+ | 'CANCELLED'+ | 'INVALID_APP_PATH'+ | 'MANIFEST_BUILD_FAILED'+ | 'BUILD_FAILED'+ | 'TYPECHECK_FAILED'+ | 'SNAPSHOT_NOT_FOUND'+ | 'SNAPSHOT_RELEASE_FAILED';++export type BuildResult<TData> =+ | { success: true; data: TData; diagnostics: BuildDiagnostic[] }+ | {+ success: false;+ error: { code: BuildErrorCode; message: string };+ diagnostics: BuildDiagnostic[];+ };++export type BuildArtifactRole =+ | 'built-logic-function'+ | 'built-front-component'+ | 'source'+ | 'dependencies'+ | 'public-asset';++export type BuildArtifact = {+ path: string;+ role: BuildArtifactRole;+ sourcePath: string;+ size: number;+ sha256: string;+};++export type BuildSnapshot = {+ buildId: string;+ directory: string;+ contentHash: string;+ application: {+ universalIdentifier: string;+ name: string;+ displayName: string;+ };+ manifestFormat: 'twenty-application';+ manifest: unknown;+ files: BuildArtifact[];+};++export type BuildOperationOptions = { appPath: string; signal?: AbortSignal };diff --git a/packages/twenty-sdk/src/application-build/validate-app-path.ts b/packages/twenty-sdk/src/application-build/validate-app-path.tsnew file mode 100644index 00000000000..60162ed23c0--- /dev/null+++ b/packages/twenty-sdk/src/application-build/validate-app-path.ts@@ -0,0 +1,24 @@+import { stat } from 'node:fs/promises';+import { isAbsolute } from 'node:path';++import { type BuildResult } from '@/application-build/types';++export const validateAppPath = async (+ appPath: string,+): Promise<BuildResult<null>> => {+ if (+ isAbsolute(appPath) &&+ (await stat(appPath).catch(() => null))?.isDirectory()+ ) {+ return { success: true, data: null, diagnostics: [] };+ }++ return {+ success: false,+ error: {+ code: 'INVALID_APP_PATH',+ message: 'appPath must be an absolute path to an existing directory.',+ },+ diagnostics: [],+ };+};diff --git a/packages/twenty-sdk/src/cli/operations/build.ts b/packages/twenty-sdk/src/cli/operations/build.tsindex aa692c4e273..ad1158acd47 100644--- a/packages/twenty-sdk/src/cli/operations/build.ts+++ b/packages/twenty-sdk/src/cli/operations/build.ts@@ -1,15 +1,16 @@import { execSync } from 'child_process';import path from 'path';-import { applyGeneratedCover } from '@/cli/utilities/build/cover/apply-generated-cover';-import { buildApplication } from '@/cli/utilities/build/common/build-application';+import { compileApplication } from '@/cli/utilities/build/common/compile-application';import { runTypecheck } from '@/cli/utilities/build/common/typecheck-plugin';-import { buildAndValidateManifest } from '@/cli/utilities/build/manifest/build-and-validate-manifest';-import { manifestUpdateChecksums } from '@/cli/utilities/build/manifest/manifest-update-checksums';-import { writeManifestToOutput } from '@/cli/utilities/build/manifest/manifest-writer';-import { compileApplicationTranslations } from '@/cli/utilities/translations/compile-application-translations';import { runSafe } from '@/cli/utilities/run-safe';import { APP_ERROR_CODES, type CommandResult } from '@/cli/types';+import { type BuildErrorCode } from '@/application-build/types';++const COMPILATION_ERROR_CODE_MAP: Partial<Record<BuildErrorCode, string>> = {+ MANIFEST_BUILD_FAILED: APP_ERROR_CODES.MANIFEST_BUILD_FAILED,+ TYPECHECK_FAILED: APP_ERROR_CODES.TYPECHECK_FAILED,+};export type AppBuildOptions = {appPath: string;@@ -28,83 +29,50 @@ const innerAppBuild = async (): Promise<CommandResult<AppBuildResult>> => {const { appPath, onProgress } = options;- onProgress?.('Building manifest...');-- const manifestResult = await buildAndValidateManifest(appPath);-- if (!manifestResult.success) {- return {- success: false,- error: {- code: APP_ERROR_CODES.MANIFEST_BUILD_FAILED,- message: manifestResult.errors.join('\n'),- },- };- }-- const { filePaths } = manifestResult;-- for (const warning of manifestResult.warnings) {- onProgress?.(`⚠ ${warning}`);- }-- const { manifest, generatedAssets } = await applyGeneratedCover({+ const compilation = await compileApplication({appPath,- manifest: manifestResult.manifest,- }).catch((error) => {- onProgress?.(- `⚠ Skipped cover image generation: ${error instanceof Error ? error.message : String(error)}`,- );-- return { manifest: manifestResult.manifest, generatedAssets: [] };- });-- if (generatedAssets.length > 0) {- onProgress?.('Generated cover image from logo');- }-- const translations = await compileApplicationTranslations(appPath);-- onProgress?.('Building application files...');-- const buildResult = await buildApplication({- appPath,- manifest,- filePaths,- generatedAssets,+ onProgress,+ onTranslationWarning: (message) => console.warn(message),+ typecheck: async () => {+ const typecheckErrors = await runTypecheck(appPath);++ if (typecheckErrors.length > 0) {+ const errorMessages = typecheckErrors.map(+ (error) =>+ `${error.file}(${error.line},${error.column + 1}): ${error.text}`,+ );++ return {+ success: false,+ error: {+ code: 'TYPECHECK_FAILED',+ message: `Typecheck failed:\n${errorMessages.join('\n')}`,+ },+ diagnostics: [],+ };+ }++ return { success: true, data: null, diagnostics: [] };+ },});- onProgress?.('Running typecheck...');-- const typecheckErrors = await runTypecheck(appPath);-- if (typecheckErrors.length > 0) {- const errorMessages = typecheckErrors.map(- (error) =>- `${error.file}(${error.line},${error.column + 1}): ${error.text}`,- );-+ if (!compilation.success) {return {success: false,error: {- code: APP_ERROR_CODES.TYPECHECK_FAILED,- message: `Typecheck failed:\n${errorMessages.join('\n')}`,+ code:+ COMPILATION_ERROR_CODE_MAP[compilation.error.code] ??+ APP_ERROR_CODES.BUILD_FAILED,+ message: compilation.error.message,},};}- const updatedManifest = manifestUpdateChecksums({- manifest,- builtFileInfos: buildResult.builtFileInfos,- });-- await writeManifestToOutput(appPath, { ...updatedManifest, translations });-const outputDir = path.join(appPath, '.twenty', 'output');const result: AppBuildResult = {outputDir,- fileCount: buildResult.builtFileInfos.size,+ fileCount: compilation.data.builtFileInfos.size,};if (options.tarball) {diff --git a/packages/twenty-sdk/src/cli/operations/dev-once.ts b/packages/twenty-sdk/src/cli/operations/dev-once.tsindex 5318f51dc8f..2521771e2cb 100644--- a/packages/twenty-sdk/src/cli/operations/dev-once.ts+++ b/packages/twenty-sdk/src/cli/operations/dev-once.ts@@ -203,7 +203,7 @@ const innerAppDevOnce = async (};}- const translations = await compileApplicationTranslations(appPath);+ const translations = await compileApplicationTranslations({ appPath });const manifest: Manifest = {...manifestUpdateChecksums({@@ -213,7 +213,7 @@ const innerAppDevOnce = async (translations,};- await writeManifestToOutput(appPath, manifest);+ await writeManifestToOutput({ appPath, manifest });const makeData = (): AppDevOnceResult => ({outputDir: path.join(appPath, OUTPUT_DIR),diff --git a/packages/twenty-sdk/src/cli/utilities/build/common/__tests__/copy-readme-to-output.test.ts b/packages/twenty-sdk/src/cli/utilities/build/common/__tests__/copy-readme-to-output.test.tsindex 87de480e151..fdea3b634fa 100644--- a/packages/twenty-sdk/src/cli/utilities/build/common/__tests__/copy-readme-to-output.test.ts+++ b/packages/twenty-sdk/src/cli/utilities/build/common/__tests__/copy-readme-to-output.test.ts@@ -1,4 +1,11 @@-import { mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';+import {+ lstat,+ mkdtemp,+ readFile,+ rm,+ symlink,+ writeFile,+} from 'node:fs/promises';import { tmpdir } from 'node:os';import { join } from 'node:path';import { OUTPUT_DIR } from 'twenty-shared/application';@@ -43,7 +50,7 @@ describe('copyReadmeToOutput', () => {it('should copy the readme into the output directory', async () => {await writeFile(join(appPath, 'README.md'), '# My App', 'utf-8');- await copyReadmeToOutput(appPath);+ await copyReadmeToOutput({ appPath });const copiedReadme = await readFile(join(appPath, OUTPUT_DIR, 'README.md'),@@ -56,8 +63,33 @@ describe('copyReadmeToOutput', () => {it('should do nothing when the app has no readme', async () => {await writeFile(join(appPath, 'package.json'), '{}', 'utf-8');- await copyReadmeToOutput(appPath);+ await copyReadmeToOutput({ appPath });expect(await pathExists(join(appPath, OUTPUT_DIR))).toBe(false);});++ it('preserves legacy symlinks and isolates snapshot readme bytes', async () => {+ const sourcePath = join(appPath, 'readme-source.txt');++ await writeFile(sourcePath, 'original readme');+ await symlink(sourcePath, join(appPath, 'README.md'));+ await copyReadmeToOutput({ appPath });+ await copyReadmeToOutput({+ appPath,+ relativeOutputDir: '.twenty/snapshots/readme/files',+ dereferenceSymlinks: true,+ });++ const legacyPath = join(appPath, OUTPUT_DIR, 'README.md');+ const snapshotPath = join(+ appPath,+ '.twenty/snapshots/readme/files/README.md',+ );++ expect((await lstat(legacyPath)).isSymbolicLink()).toBe(true);+ expect((await lstat(snapshotPath)).isSymbolicLink()).toBe(false);+ await writeFile(sourcePath, 'changed readme');+ expect(await readFile(legacyPath, 'utf8')).toBe('changed readme');+ expect(await readFile(snapshotPath, 'utf8')).toBe('original readme');+ });});diff --git a/packages/twenty-sdk/src/cli/utilities/build/common/build-application.ts b/packages/twenty-sdk/src/cli/utilities/build/common/build-application.tsindex f608dafda7b..fb72a8c376e 100644--- a/packages/twenty-sdk/src/cli/utilities/build/common/build-application.ts+++ b/packages/twenty-sdk/src/cli/utilities/build/common/build-application.ts@@ -9,6 +9,7 @@ import {import { FileFolder } from 'twenty-shared/types';import { isDefined } from 'twenty-shared/utils';+import { copyBuildFile } from '@/cli/utilities/build/common/copy-build-file';import { copyReadmeToOutput } from '@/cli/utilities/build/common/copy-readme-to-output';import { type GeneratedAsset } from '@/cli/utilities/build/cover/generated-asset.type';import { esbuildOneShotBuild } from '@/cli/utilities/build/common/esbuild-one-shot-build';@@ -22,7 +23,6 @@ import { type SharedDependenciesBuildContext } from '@/cli/utilities/build/commoimport { type EntityFilePaths } from '@/cli/utilities/build/manifest/manifest-extract-config';import { loadFrontComponentTranslationCatalogs } from '@/cli/utilities/translations/load-front-component-translation-catalogs';import {- copy,emptyDir,ensureDir,pathExists,@@ -35,6 +35,8 @@ export type AppBuildOptions = {manifest: Manifest;filePaths: EntityFilePaths;generatedAssets?: GeneratedAsset[];+ outputDir?: string;+ dereferenceSymlinks?: boolean;};export type BuiltFileInfo = {@@ -52,7 +54,8 @@ export type AppBuildResult = {export const buildApplication = async (options: AppBuildOptions,): Promise<AppBuildResult> => {- const outputDir = join(options.appPath, OUTPUT_DIR);+ const relativeOutputDir = options.outputDir ?? OUTPUT_DIR;+ const outputDir = join(options.appPath, relativeOutputDir);await ensureDir(outputDir);await emptyDir(outputDir);@@ -99,7 +102,7 @@ export const buildApplication = async (splitting: false,format: 'esm',platform: 'node',- outdir: join(options.appPath, OUTPUT_DIR),+ outdir: outputDir,outExtension: { '.js': '.mjs' },external: LOGIC_FUNCTION_EXTERNAL_MODULES,tsconfig: join(options.appPath, 'tsconfig.json'),@@ -116,6 +119,7 @@ export const buildApplication = async (isDefined(sharedDependencies)? await buildSharedDependenciesBundle({appPath: options.appPath,+ outputDir: relativeOutputDir,sharedDependencies,onFileBuilt: collectFileBuilt,})@@ -127,7 +131,7 @@ export const buildApplication = async (fileFolder: FileFolder.BuiltFrontComponent,buildOptions: {...getBaseFrontComponentBuildOptions(),- outdir: join(options.appPath, OUTPUT_DIR),+ outdir: outputDir,tsconfig: join(options.appPath, 'tsconfig.json'),jsx: 'automatic',sourcemap: true,@@ -152,6 +156,8 @@ export const buildApplication = async (fileFolder: FileFolder.Source,filePaths: [...new Set([...logicFunctions, ...frontComponents])],collectFileBuilt,+ outputDir: relativeOutputDir,+ dereferenceSymlinks: options.dereferenceSymlinks,});await copyStaticFiles({@@ -159,6 +165,8 @@ export const buildApplication = async (fileFolder: FileFolder.PublicAsset,filePaths: options.filePaths.publicAssets,collectFileBuilt,+ outputDir: relativeOutputDir,+ dereferenceSymlinks: options.dereferenceSymlinks,});await copyStaticFiles({@@ -168,17 +176,24 @@ export const buildApplication = async (pathExistsSync(join(options.appPath, filePath)),),collectFileBuilt,+ outputDir: relativeOutputDir,+ dereferenceSymlinks: options.dereferenceSymlinks,});for (const generatedAsset of options.generatedAssets ?? []) {await writeGeneratedAsset({appPath: options.appPath,generatedAsset,+ outputDir: relativeOutputDir,collectFileBuilt,});}- await copyReadmeToOutput(options.appPath);+ await copyReadmeToOutput({+ appPath: options.appPath,+ relativeOutputDir,+ dereferenceSymlinks: options.dereferenceSymlinks,+ });return { builtFileInfos };};@@ -186,13 +201,15 @@ export const buildApplication = async (const writeGeneratedAsset = async ({appPath,generatedAsset,+ outputDir,collectFileBuilt,}: {appPath: string;generatedAsset: GeneratedAsset;+ outputDir: string;collectFileBuilt: OnFileBuiltCallback;}) => {- const builtPath = join(OUTPUT_DIR, generatedAsset.relativePath);+ const builtPath = join(outputDir, generatedAsset.relativePath);const absoluteBuiltPath = join(appPath, builtPath);await ensureDir(dirname(absoluteBuiltPath));@@ -215,11 +232,15 @@ const copyStaticFiles = async ({appPath,fileFolder,filePaths,+ outputDir,+ dereferenceSymlinks = false,collectFileBuilt,}: {appPath: string;fileFolder: FileFolder;filePaths: string[];+ outputDir: string;+ dereferenceSymlinks?: boolean;collectFileBuilt: OnFileBuiltCallback;}) => {for (const sourcePath of filePaths) {@@ -229,11 +250,15 @@ const copyStaticFiles = async ({continue;}- const builtPath = join(OUTPUT_DIR, sourcePath);+ const builtPath = join(outputDir, sourcePath);const absoluteBuiltPath = join(appPath, builtPath);await ensureDir(dirname(absoluteBuiltPath));- await copy(absoluteSourcePath, absoluteBuiltPath);+ await copyBuildFile({+ sourcePath: absoluteSourcePath,+ destinationPath: absoluteBuiltPath,+ dereferenceSymlinks,+ });const content = await readFile(absoluteBuiltPath);const checksum = crypto.createHash('md5').update(content).digest('hex');diff --git a/packages/twenty-sdk/src/cli/utilities/build/common/compile-application.ts b/packages/twenty-sdk/src/cli/utilities/build/common/compile-application.tsnew file mode 100644index 00000000000..ecb653da9bb--- /dev/null+++ b/packages/twenty-sdk/src/cli/utilities/build/common/compile-application.ts@@ -0,0 +1,124 @@+import { OUTPUT_DIR, type Manifest } from 'twenty-shared/application';++import {+ type BuildDiagnostic,+ type BuildResult,+} from '@/application-build/types';+import {+ buildApplication,+ type BuiltFileInfo,+} from '@/cli/utilities/build/common/build-application';+import { applyGeneratedCover } from '@/cli/utilities/build/cover/apply-generated-cover';+import { buildAndValidateManifest } from '@/cli/utilities/build/manifest/build-and-validate-manifest';+import { manifestUpdateChecksums } from '@/cli/utilities/build/manifest/manifest-update-checksums';+import { writeManifestToOutput } from '@/cli/utilities/build/manifest/manifest-writer';+import { compileApplicationTranslations } from '@/cli/utilities/translations/compile-application-translations';+import { typecheckApplication } from '@/application-build/typecheck-application';++export const compileApplication = async ({+ appPath,+ outputDir = OUTPUT_DIR,+ dereferenceSymlinks = false,+ onProgress,+ onTranslationWarning,+ signal,+ typecheck = typecheckApplication,+}: {+ appPath: string;+ outputDir?: string;+ dereferenceSymlinks?: boolean;+ onProgress?: (message: string) => void;+ onTranslationWarning?: (message: string) => void;+ signal?: AbortSignal;+ typecheck?: typeof typecheckApplication;+}): Promise<+ BuildResult<{+ manifest: Manifest;+ builtFileInfos: Map<string, BuiltFileInfo>;+ }>+> => {+ const diagnostics: BuildDiagnostic[] = [];+ const warn = (message: string) => {+ diagnostics.push({ severity: 'warning', code: 'BUILD_WARNING', message });+ onProgress?.(`⚠ ${message}`);+ };++ signal?.throwIfAborted();+ onProgress?.('Building manifest...');+ const manifestResult = await buildAndValidateManifest(appPath);++ if (!manifestResult.success) {+ return {+ success: false,+ error: {+ code: 'MANIFEST_BUILD_FAILED',+ message: manifestResult.errors.join('\n'),+ },+ diagnostics: manifestResult.errors.map((message) => ({+ severity: 'error',+ code: 'MANIFEST_BUILD_FAILED',+ message,+ })),+ };+ }++ manifestResult.warnings.forEach(warn);++ signal?.throwIfAborted();+ const { manifest, generatedAssets } = await applyGeneratedCover({+ appPath,+ manifest: manifestResult.manifest,+ }).catch((error) => {+ warn(+ `Skipped cover image generation: ${error instanceof Error ? error.message : String(error)}`,+ );++ return { manifest: manifestResult.manifest, generatedAssets: [] };+ });++ if (generatedAssets.length > 0) {+ onProgress?.('Generated cover image from logo');+ }++ const translations = await compileApplicationTranslations({+ appPath,+ onWarning: onTranslationWarning ?? warn,+ });++ signal?.throwIfAborted();+ onProgress?.('Building application files...');+ const { builtFileInfos } = await buildApplication({+ appPath,+ manifest,+ filePaths: manifestResult.filePaths,+ generatedAssets,+ outputDir,+ dereferenceSymlinks,+ });++ onProgress?.('Running typecheck...');+ const typecheckResult = await typecheck({ appPath, signal });++ diagnostics.push(...typecheckResult.diagnostics);++ if (!typecheckResult.success) {+ return { ...typecheckResult, diagnostics };+ }++ const updatedManifest = {+ ...manifestUpdateChecksums({ manifest, builtFileInfos, outputDir }),+ translations,+ };++ await writeManifestToOutput({+ appPath,+ manifest: updatedManifest,+ relativeOutputDir: outputDir,+ });++ return {+ success: true,+ data: { manifest: updatedManifest, builtFileInfos },+ diagnostics,+ };+};diff --git a/packages/twenty-sdk/src/cli/utilities/build/common/copy-build-file.ts b/packages/twenty-sdk/src/cli/utilities/build/common/copy-build-file.tsnew file mode 100644index 00000000000..b8a7741cfe3--- /dev/null+++ b/packages/twenty-sdk/src/cli/utilities/build/common/copy-build-file.ts@@ -0,0 +1,19 @@+import { copyFile } from 'node:fs/promises';++import { copy } from '@/cli/utilities/file/fs-utils';++export const copyBuildFile = ({+ sourcePath,+ destinationPath,+ dereferenceSymlinks = false,+}: {+ sourcePath: string;+ destinationPath: string;+ dereferenceSymlinks?: boolean;+}): Promise<void> => {+ if (dereferenceSymlinks) {+ return copyFile(sourcePath, destinationPath);+ }++ return copy(sourcePath, destinationPath);+};diff --git a/packages/twenty-sdk/src/cli/utilities/build/common/copy-readme-to-output.ts b/packages/twenty-sdk/src/cli/utilities/build/common/copy-readme-to-output.tsindex 6a86d8b7d58..c29b3fbb4d9 100644--- a/packages/twenty-sdk/src/cli/utilities/build/common/copy-readme-to-output.ts+++ b/packages/twenty-sdk/src/cli/utilities/build/common/copy-readme-to-output.ts@@ -2,15 +2,14 @@ import { readdir } from 'node:fs/promises';import { join } from 'node:path';import { OUTPUT_DIR } from 'twenty-shared/application';-import { copy, ensureDir } from '@/cli/utilities/file/fs-utils';+import { copyBuildFile } from '@/cli/utilities/build/common/copy-build-file';+import { ensureDir } from '@/cli/utilities/file/fs-utils';// npm only ships a README when the file lives in the package root, so the// app's readme has to be copied into the build output that gets published.const README_FILE_NAME_REGEX = /^readme(\.[^.]+)?$/i;-export const findReadmeFileName = (- entries: string[],-): string | undefined => {+export const findReadmeFileName = (entries: string[]): string | undefined => {const readmeFileNames = entries.filter((entry) =>README_FILE_NAME_REGEX.test(entry),);@@ -21,15 +20,26 @@ export const findReadmeFileName = ();};-export const copyReadmeToOutput = async (appPath: string): Promise<void> => {+export const copyReadmeToOutput = async ({+ appPath,+ relativeOutputDir = OUTPUT_DIR,+ dereferenceSymlinks = false,+}: {+ appPath: string;+ relativeOutputDir?: string;+ dereferenceSymlinks?: boolean;+}): Promise<void> => {const readmeFileName = findReadmeFileName(await readdir(appPath));if (readmeFileName === undefined) {return;}- const outputDir = join(appPath, OUTPUT_DIR);+ const outputDir = join(appPath, relativeOutputDir);await ensureDir(outputDir);- await copy(join(appPath, readmeFileName), join(outputDir, readmeFileName));+ const sourcePath = join(appPath, readmeFileName);+ const destinationPath = join(outputDir, readmeFileName);++ await copyBuildFile({ sourcePath, destinationPath, dereferenceSymlinks });};diff --git a/packages/twenty-sdk/src/cli/utilities/build/common/front-component-build/shared-dependencies-build/build-shared-dependencies-bundle.ts b/packages/twenty-sdk/src/cli/utilities/build/common/front-component-build/shared-dependencies-build/build-shared-dependencies-bundle.tsindex 4f1337fafbc..f62df6a8030 100644--- a/packages/twenty-sdk/src/cli/utilities/build/common/front-component-build/shared-dependencies-build/build-shared-dependencies-bundle.ts+++ b/packages/twenty-sdk/src/cli/utilities/build/common/front-component-build/shared-dependencies-build/build-shared-dependencies-bundle.ts@@ -19,9 +19,11 @@ import { isNonEmptyArray } from '@sniptt/guards';export const buildSharedDependenciesBundle = async ({appPath,sharedDependencies,+ outputDir = OUTPUT_DIR,onFileBuilt,}: {appPath: string;+ outputDir?: string;sharedDependencies: FrontComponentSharedDependenciesManifest;onFileBuilt: OnFileBuiltCallback;}): Promise<SharedDependenciesBuildContext> => {@@ -37,7 +39,7 @@ export const buildSharedDependenciesBundle = async ({);}- const builtPath = join(OUTPUT_DIR, sharedDependencies.builtPath);+ const builtPath = join(outputDir, sharedDependencies.builtPath);const absoluteBuiltPath = join(appPath, builtPath);await ensureDir(dirname(absoluteBuiltPath));diff --git a/packages/twenty-sdk/src/cli/utilities/build/manifest/manifest-update-checksums.ts b/packages/twenty-sdk/src/cli/utilities/build/manifest/manifest-update-checksums.tsindex 771e3c7b465..6a7361fec8e 100644--- a/packages/twenty-sdk/src/cli/utilities/build/manifest/manifest-update-checksums.ts+++ b/packages/twenty-sdk/src/cli/utilities/build/manifest/manifest-update-checksums.ts@@ -12,6 +12,7 @@ export type ManifestBuildResult = {};export type UpdateManifestChecksumParams = {+ outputDir?: string;manifest: Manifest;builtFileInfos: Map<string,@@ -27,13 +28,14 @@ export type UpdateManifestChecksumParams = {export const manifestUpdateChecksums = ({manifest,builtFileInfos,+ outputDir = OUTPUT_DIR,}: UpdateManifestChecksumParams): Manifest => {let result = structuredClone(manifest);for (const [builtPath,{ fileFolder, checksum },] of builtFileInfos.entries()) {- const rootBuiltPath = relative(OUTPUT_DIR, builtPath);+ const rootBuiltPath = relative(outputDir, builtPath);if (fileFolder === FileFolder.BuiltLogicFunction) {const logicFunctions = result.logicFunctions;const fnIndex = logicFunctions.findIndex(diff --git a/packages/twenty-sdk/src/cli/utilities/build/manifest/manifest-writer.ts b/packages/twenty-sdk/src/cli/utilities/build/manifest/manifest-writer.tsindex de5478c77ec..dd77bb9515e 100644--- a/packages/twenty-sdk/src/cli/utilities/build/manifest/manifest-writer.ts+++ b/packages/twenty-sdk/src/cli/utilities/build/manifest/manifest-writer.ts@@ -3,11 +3,16 @@ import path from 'path';import { ensureDir, writeJson } from '@/cli/utilities/file/fs-utils';import { type Manifest, OUTPUT_DIR } from 'twenty-shared/application';-export const writeManifestToOutput = async (- appPath: string,- manifest: Manifest,-): Promise<string> => {- const outputDir = path.join(appPath, OUTPUT_DIR);+export const writeManifestToOutput = async ({+ appPath,+ manifest,+ relativeOutputDir = OUTPUT_DIR,+}: {+ appPath: string;+ manifest: Manifest;+ relativeOutputDir?: string;+}): Promise<string> => {+ const outputDir = path.join(appPath, relativeOutputDir);await ensureDir(outputDir);const manifestPath = path.join(outputDir, 'manifest.json');diff --git a/packages/twenty-sdk/src/cli/utilities/dev/orchestrator/steps/sync-application-orchestrator-step.ts b/packages/twenty-sdk/src/cli/utilities/dev/orchestrator/steps/sync-application-orchestrator-step.tsindex 9edee4e050d..4a936382050 100644--- a/packages/twenty-sdk/src/cli/utilities/dev/orchestrator/steps/sync-application-orchestrator-step.ts+++ b/packages/twenty-sdk/src/cli/utilities/dev/orchestrator/steps/sync-application-orchestrator-step.ts@@ -82,12 +82,14 @@ export class SyncApplicationOrchestratorStep {manifest: input.manifest,builtFileInfos: input.builtFileInfos,}),- translations: await compileApplicationTranslations(input.appPath),+ translations: await compileApplicationTranslations({+ appPath: input.appPath,+ }),};events.push({ message: 'Manifest checksums set', status: 'info' });- await writeManifestToOutput(input.appPath, manifest);+ await writeManifestToOutput({ appPath: input.appPath, manifest });events.push({message: 'Manifest saved to output directory',diff --git a/packages/twenty-sdk/src/cli/utilities/pull/__integration__/pull-round-trip.integration.spec.ts b/packages/twenty-sdk/src/cli/utilities/pull/__integration__/pull-round-trip.integration.spec.tsindex 4778015c994..c7e8b1ac05d 100644--- a/packages/twenty-sdk/src/cli/utilities/pull/__integration__/pull-round-trip.integration.spec.ts+++ b/packages/twenty-sdk/src/cli/utilities/pull/__integration__/pull-round-trip.integration.spec.ts@@ -727,7 +727,7 @@ describe('pull round trip', () => {await readFile(join(appPath, 'locales/compiled/fr-FR.json'), 'utf8'),),).toEqual({ zzzzzz: 'orphan' });- expect(await compileApplicationTranslations(appPath)).toEqual(+ expect(await compileApplicationTranslations({ appPath })).toEqual(EXPORTED_TRANSLATIONS,);});diff --git a/packages/twenty-sdk/src/cli/utilities/pull/__tests__/plan-translation-writes.spec.ts b/packages/twenty-sdk/src/cli/utilities/pull/__tests__/plan-translation-writes.spec.tsindex e1f05d5d63e..e5012b2c343 100644--- a/packages/twenty-sdk/src/cli/utilities/pull/__tests__/plan-translation-writes.spec.ts+++ b/packages/twenty-sdk/src/cli/utilities/pull/__tests__/plan-translation-writes.spec.ts@@ -104,7 +104,7 @@ describe('planTranslationWrites', () => {deletions: [],});expect(plan.compiledEntryCountByLocale).toEqual({ 'fr-FR': 1 });- expect(await compileApplicationTranslations(appPath)).toEqual(+ expect(await compileApplicationTranslations({ appPath })).toEqual(EXPORTED_TRANSLATIONS,);});diff --git a/packages/twenty-sdk/src/cli/utilities/translations/__tests__/application-translations.spec.ts b/packages/twenty-sdk/src/cli/utilities/translations/__tests__/application-translations.spec.tsindex f9bf8f1b515..062211fa076 100644--- a/packages/twenty-sdk/src/cli/utilities/translations/__tests__/application-translations.spec.ts+++ b/packages/twenty-sdk/src/cli/utilities/translations/__tests__/application-translations.spec.ts@@ -155,7 +155,7 @@ describe('compileApplicationTranslations', () => {JSON.stringify({ Company: 'Company' }),);- const result = await compileApplicationTranslations(appPath);+ const result = await compileApplicationTranslations({ appPath });expect(result).toEqual({'fr-FR': { [generateMessageId('Company')]: 'Entreprise' },@@ -176,7 +176,7 @@ describe('compileApplicationTranslations', () => {}),);- const result = await compileApplicationTranslations(appPath);+ const result = await compileApplicationTranslations({ appPath });expect(result).toEqual({'fr-FR': { [generateMessageId('Open', 'door')]: 'Ouvrir' },@@ -186,7 +186,7 @@ describe('compileApplicationTranslations', () => {it('declares nothing when there is no locales directory, so the sync leaves stored translations alone', async () => {const appPath = await mkdtemp(join(tmpdir(), 'twenty-translations-empty-'));- expect(await compileApplicationTranslations(appPath)).toBeUndefined();+ expect(await compileApplicationTranslations({ appPath })).toBeUndefined();});it('declares zero locales when the locales directory exists but holds none', async () => {@@ -196,7 +196,7 @@ describe('compileApplicationTranslations', () => {await mkdir(join(appPath, 'locales'), { recursive: true });- expect(await compileApplicationTranslations(appPath)).toEqual({});+ expect(await compileApplicationTranslations({ appPath })).toEqual({});});it('declares zero locales when only the source locale is present', async () => {@@ -211,7 +211,7 @@ describe('compileApplicationTranslations', () => {JSON.stringify({ Company: 'Company' }),);- expect(await compileApplicationTranslations(appPath)).toEqual({});+ expect(await compileApplicationTranslations({ appPath })).toEqual({});});it('merges compiled catalogs and lets an authored entry win on the same id', async () => {@@ -230,7 +230,7 @@ describe('compileApplicationTranslations', () => {}),);- expect(await compileApplicationTranslations(appPath)).toEqual({+ expect(await compileApplicationTranslations({ appPath })).toEqual({'fr-FR': {[generateMessageId('Company')]: 'Entreprise',zzzzzz: 'orphan',@@ -248,7 +248,7 @@ describe('compileApplicationTranslations', () => {JSON.stringify({ zzzzzz: 'Waise' }),);- expect(await compileApplicationTranslations(appPath)).toEqual({+ expect(await compileApplicationTranslations({ appPath })).toEqual({'de-DE': { zzzzzz: 'Waise' },});});@@ -267,7 +267,7 @@ describe('compileApplicationTranslations', () => {JSON.stringify({ cccccc: 'nuqneH' }),);- expect(await compileApplicationTranslations(appPath)).toEqual({+ expect(await compileApplicationTranslations({ appPath })).toEqual({'fr-FR': { bbbbbb: 'kept' },});});@@ -285,7 +285,7 @@ describe('compileApplicationTranslations', () => {JSON.stringify({ Company: 'Azienda' }),);- expect(await compileApplicationTranslations(appPath)).toEqual({+ expect(await compileApplicationTranslations({ appPath })).toEqual({'it-IT': { [generateMessageId('Company')]: 'Azienda' },});});@@ -303,7 +303,7 @@ describe('compileApplicationTranslations', () => {JSON.stringify({ Company: 'Azienda' }),);- expect(await compileApplicationTranslations(appPath)).toEqual({+ expect(await compileApplicationTranslations({ appPath })).toEqual({'it-IT': { [generateMessageId('Company')]: 'Azienda' },});});diff --git a/packages/twenty-sdk/src/cli/utilities/translations/compile-application-translations.ts b/packages/twenty-sdk/src/cli/utilities/translations/compile-application-translations.tsindex 983cc1d0f49..85761a5b800 100644--- a/packages/twenty-sdk/src/cli/utilities/translations/compile-application-translations.ts+++ b/packages/twenty-sdk/src/cli/utilities/translations/compile-application-translations.ts@@ -12,15 +12,19 @@ import { type TranslationsManifest } from 'twenty-shared/application';import { SOURCE_LOCALE } from 'twenty-shared/translations';import { isDefined } from 'twenty-shared/utils';-const readLocaleCatalogFile = async (- filePath: string,-): Promise<Record<string, unknown> | null> => {+const readLocaleCatalogFile = async ({+ filePath,+ onWarning,+}: {+ filePath: string;+ onWarning: (message: string) => void;+}): Promise<Record<string, unknown> | null> => {let parsed: unknown;try {parsed = await readJson<unknown>(filePath);} catch {- console.warn(+ onWarning(`Skipping translation file "${path.basename(filePath)}": it is not valid JSON.`,);@@ -32,7 +36,7 @@ const readLocaleCatalogFile = async (typeof parsed !== 'object' ||Array.isArray(parsed)) {- console.warn(+ onWarning(`Skipping translation file "${path.basename(filePath)}": expected a JSON object.`,);@@ -42,9 +46,13 @@ const readLocaleCatalogFile = async (return parsed as Record<string, unknown>;};-const readCompiledCatalogs = async (- appPath: string,-): Promise<Record<string, Record<string, string>>> => {+const readCompiledCatalogs = async ({+ appPath,+ onWarning,+}: {+ appPath: string;+ onWarning: (message: string) => void;+}): Promise<Record<string, Record<string, string>>> => {const compiledDir = path.join(appPath, COMPILED_LOCALES_DIR);if (!(await pathExists(compiledDir))) {@@ -63,15 +71,16 @@ const readCompiledCatalogs = async (}if (!isSupportedLocale(locale)) {- console.warn(+ onWarning(`Skipping compiled translation file "${compiledFile}": "${locale}" is not a supported locale.`,);continue;}- const compiledCatalog = await readLocaleCatalogFile(- path.join(compiledDir, compiledFile),- );+ const compiledCatalog = await readLocaleCatalogFile({+ filePath: path.join(compiledDir, compiledFile),+ onWarning,+ });if (compiledCatalog === null) {continue;@@ -92,9 +101,13 @@ const readCompiledCatalogs = async (return catalogs;};-export const compileApplicationTranslations = async (- appPath: string,-): Promise<TranslationsManifest | undefined> => {+export const compileApplicationTranslations = async ({+ appPath,+ onWarning = (message) => console.warn(message),+}: {+ appPath: string;+ onWarning?: (message: string) => void;+}): Promise<TranslationsManifest | undefined> => {const localesDir = path.join(appPath, LOCALES_DIR);if (!(await pathExists(localesDir))) {@@ -115,15 +128,16 @@ export const compileApplicationTranslations = async (}if (!isSupportedLocale(locale)) {- console.warn(+ onWarning(`Skipping translation file "${localeFile}": "${locale}" is not a supported locale.`,);continue;}- const sourceToTranslation = await readLocaleCatalogFile(- path.join(localesDir, localeFile),- );+ const sourceToTranslation = await readLocaleCatalogFile({+ filePath: path.join(localesDir, localeFile),+ onWarning,+ });if (sourceToTranslation === null) {continue;@@ -132,7 +146,7 @@ export const compileApplicationTranslations = async (const compiled = compileCatalogToMessageIds({catalog: sourceToTranslation,onCollision: ({ messageId, keptKey, droppedKey }) =>- console.warn(+ onWarning(`Message id collision in "${localeFile}": "${keptKey}" and "${droppedKey}" share id "${messageId}". Keeping "${keptKey}".`,),});@@ -143,7 +157,7 @@ export const compileApplicationTranslations = async (}for (const [locale, messages] of Object.entries(- await readCompiledCatalogs(appPath),+ await readCompiledCatalogs({ appPath, onWarning }),)) {translations[locale] = { ...messages, ...(translations[locale] ?? {}) };}diff --git a/packages/twenty-sdk/vite.config.node.ts b/packages/twenty-sdk/vite.config.node.tsindex 887d82131b8..8e59b11ac83 100644--- a/packages/twenty-sdk/vite.config.node.ts+++ b/packages/twenty-sdk/vite.config.node.ts@@ -4,6 +4,7 @@ import { type PackageJson } from 'type-fest';import { defineConfig } from 'vite';import packageJson from './package.json';+import { BUILD_DESCRIPTOR } from './src/application-build/build-descriptor';// Injected at the top of every ESM chunk so bundled CommonJS modules keep// working after rolldown inlines them into the `.mjs` output. They call@@ -41,6 +42,17 @@ const copyCoverAssetsPlugin = () => ({},});+const writeBuildDescriptorPlugin = () => ({+ name: 'write-build-descriptor',+ closeBundle() {+ fs.mkdirSync(path.resolve(__dirname, 'dist/build'), { recursive: true });+ fs.writeFileSync(+ path.resolve(__dirname, 'dist/build/descriptor.json'),+ JSON.stringify(BUILD_DESCRIPTOR, null, 2) + '\n',+ );+ },+});+export default defineConfig(() => {return {root: __dirname,@@ -51,7 +63,7 @@ export default defineConfig(() => {'@/': path.resolve(__dirname, 'src') + '/',},},- plugins: [copyCoverAssetsPlugin()],+ plugins: [copyCoverAssetsPlugin(), writeBuildDescriptorPlugin()],build: {emptyOutDir: false,outDir: 'dist',@@ -59,6 +71,7 @@ export default defineConfig(() => {entry: {cli: 'src/cli/cli.ts',operations: 'src/cli/operations/index.ts',+ build: 'src/application-build/index.ts','front-component-renderer/build':'src/front-component-renderer/build/index.ts',},