github twentyhq/twenty sdk/v2.61.0

latest release: twenty/v2.61.0
37 minutes ago

Nine breaking changes ship here. Billing types are the main target: planKey on BillingSubscriptionItem is now nullable, the metered API is removed, and ... on BillingLicensedProduct fragments need updating. navigationMenuItem.folderId renames to parentId and upsertRowLevelPermissionPredicates moves to a rules array. recordShare and accessGroup are removed as standard workspace objects.

App manifests gain billing.prices for real-currency per-member pricing. Agents support isPrivate and createdByUserWorkspaceId. Three new APIs — connectedAccount, READ_PRIVATE_CHANNELS, and calendarChannels — let an app map calendar channels to their owners without user context.

twenty app pull now restores both frontend dependencies and logic-function sources. twenty app dev --verbose shows the full watch scope.

⚠️ Breaking changes

  • defineHealthCheck now accepts runOnUserPreferences: true to show the check in member preferences; without it, checks only run in workspace settings. (#29242) by @ehconitin
  • upsertRowLevelPermissionPredicates is removed; replace calls with the rules-based API, passing each rule as an object with its own operations array and predicate groups. (#30252) by @charlesBochet
  • Recurring Google Calendar events are synced at most 90 days ahead; queries for calendarEvents will return fewer occurrences for recurring meetings with no end date. (#30335) by @neo773
  • FeatureFlagKey.IS_APP_PREFERENCES_ENABLED is removed from the enum; delete any references to it. (#30494) by @ehconitin
  • [BREAKING_CHANGE] Add a 2.60 command that drops the workspace workflowVersion object (#30500) by @thomtrp
  • Validation rule builders gain dateDiff, dateAdd, dateTrunc, and datePart; existing builder snapshots have changed, so regenerate or update call sites. (#30527) by @FelixMalfait
  • navigationMenuItem.folderId is renamed to parentId and the relation becomes parent; update all queries and mutations that reference the old name. (#30543) by @thomtrp
  • FeatureFlagKey.IS_HTTP_EGRESS_LAMBDA_ENABLED is removed from the enum; delete any references to it. (#30544) by @prastoin
  • The upgradeApplication mutation is removed from the generated client SDK; use triggerUpgradeApplication instead. (#30565) by @charlesBochet
  • EngineComponentKey.SEE_VERSION_WORKFLOW_RUN is removed; delete any references to this enum value. (#30664) by @thomtrp
  • [BREAKING_CHANGE] Add the APPLICATION billing product key and make the product plan key nullable (#30773) by @martmull
  • The metered billing catalog is removed; listPlans no longer returns a metered bucket and ... on BillingLicensedProduct fragments must be updated. (#30798) by @etiennejouan
  • recordShare and accessGroup are removed as standard workspace objects; all data has been migrated to the permission tables. (#31091) by @charlesBochet
  • findWorkspaceFromInviteHash now returns WorkspaceFromInviteHash instead of Workspace; update type references to the narrowed DTO. (#31108) by @prastoin

🌟 Highlights

  • BillingSubscriptionItem.planKey is now nullable; guard null reads and update ... on BillingLicensedProduct fragments to match the new BillingProduct/BillingLicensedProduct hierarchy. (#30773)
  • navigationMenuItem.folderId is renamed to parentId; update all queries and mutations that reference the old field. (#30543)
  • upsertRowLevelPermissionPredicates now takes a rules array instead of a flat predicate tree; rewrite calls to pass rule objects each with their own operations. (#30252)
  • recordShare and accessGroup are removed as standard workspace objects; they now live only in the permission tables. (#31091)
  • twenty app pull now restores logic-function handlers and local imports; a pulled project can rebuild with a zero-change plan. (#30665)
  • App manifests now accept a billing.prices array for declaring real-currency per-member or flat-fee pricing. (#30745)

✨ New features

  • A tool's frontComponentUniversalIdentifier now renders in the approval card as well as during active calls; no code change required. (#30317) by @FelixMalfait
  • createMcpServer and updateMcpServer now accept a signInScope field (USER or WORKSPACE) to attach OAuth sign-in to MCP servers. (#30356) by @abdulrahmancodes
  • NavigationMenuItemType gains TAB and SECTION values for creating hierarchical sidebar items. (#30566) by @thomtrp
  • CalendarChannel now exposes connectedAccount { userWorkspaceId } for reading the channel owner; non-owners receive null. (#30618) by @ehconitin
  • New READ_PRIVATE_CHANNELS app permission flag grants access to every member's channel public info when running without user context. (#30619) by @ehconitin
  • New calendarChannels metadata query returns all workspace calendar channels with owner info; requires the READ_PRIVATE_CHANNELS flag. (#30624) by @ehconitin
  • viewSort.relationTargetFieldMetadataId lets you persist a sort on a field of the related record, e.g. People sorted by Company employees. (#30657) by @FelixMalfait
  • twenty app pull now restores logic-function handlers and their local imports; a pulled project can rebuild and apply with a zero-change plan. (#30665) by @Weiko
  • Navigation menu items expose a new builtInSectionKey field that identifies built-in sidebar sections such as favorites and aiChatInbox. (#30701) by @thomtrp
  • App manifests now accept a billing.prices array; each entry can be flat-fee or per-member on a monthly or yearly period. (#30745) by @martmull
  • Agents now support isPrivate: true with a createdByUserWorkspaceId owner; a private agent is visible only to its owner. (#30772) by @Weiko
  • twenty app dev --verbose prints all watched files, external paths, and excluded folders after the first build. (#30790) by @Weiko
  • New upsertWebPushSubscription mutation registers the current browser session to receive inbox push notifications. (#30811) by @etiennejouan
  • MCP servers can now be shipped as bundled apps using source: bundled in the app manifest, with no npm package required. (#30950) by @FelixMalfait
  • Row-level permission predicates can now traverse a relation to compare against member values, e.g. opportunity.company IS my accountTeamMember.account. (#31123) by @charlesBochet
  • Object metadata now includes a server-computed canReadSomeRecords boolean so front-end code no longer needs to replicate the access decision. (#31144) by @charlesBochet

💅 Improvements & UX

  • The Shortcut component in twenty-ui now renders keys as plain light text instead of keycap-bordered chips; visible output will change. (#30503) by @thomtrp
  • Standard navigation menu items now support an isActive override; hard-deleting a standard item is replaced by setting isActive: false. (#30860) by @thomtrp
  • New workspaceApplicationConnectedMemberCounts query returns per-app connected-member counts server-side, replacing client-side authorization fetches. (#31089) by @FelixMalfait

🐛 Bug fixes

  • twenty app publish now accepts npm 12's object-keyed pack output in addition to the array shape. (#30555) by @cassio-groh
  • An existing account invited to a second workspace can now complete SSO sign-in using a personal invite token. (#30556) by @charlesBochet
  • twenty app pull now restores all source files imported by a frontend component, not just the entry TSX. (#30613) by @Weiko
  • twenty local start now detects saved-remote port mismatches and prints the full login command with --replace. (#30625) by @Weiko
  • twenty app dev no longer traverses parent directories when watching source files referenced from outside the app folder. (#30789) by @Weiko
  • Generated SDK clients that contain */ inside GraphQL field descriptions are fixed; previously those clients produced broken JavaScript. (#31005) by @prastoin

🔧 Developer & API

  • vite is now declared as a devDependency of twenty-ui; it resolves correctly in isolated installs without relying on hoisting. (#31083) by @mabdullahabaid
🏗️ Internal changes (7)

🎉 New contributors

Full changelog (49 PRs)
  • [BREAKING_CHANGE] Show member health checks in Apps preferences (#29242) by @ehconitin
  • [BREAKING_CHANGE] Upsert row-level permission rules instead of a predicate tree (#30252) by @charlesBochet
  • Let a tool's front component replace the raw arguments on its approval card (#30317) by @FelixMalfait
  • Import recurring Google Calendar meetings only up to 90 days ahead (#30335) by @neo773
  • Sign in to MCP servers through an oauth-discovery connection provider (#30356) by @abdulrahmancodes
  • Add lookup columns to table views (#30439) by @FelixMalfait
  • Remove the IS_APP_PREFERENCES_ENABLED feature flag (#30494) by @ehconitin
  • [BREAKING_CHANGE] Add a 2.60 command that drops the workspace workflowVersion object (#30500) by @thomtrp
  • Restyle shortcuts, sidebar section titles and unread dots (#30503) by @thomtrp
  • chore: bump version to 2.60.0 (#30507) by @twenty-pr
  • [BREAKING_CHANGE] Add generic date functions to validation rules (#30527) by @FelixMalfait
  • Rename the navigation menu item folderId to parentId (#30543) by @thomtrp
  • Remove the IS_HTTP_EGRESS_LAMBDA_ENABLED feature flag (#30544) by @prastoin
  • Accept npm 12 pack output in app publish (#30555) by @cassio-groh
  • Let an existing account join a workspace through SSO with its personal invite token (#30556) by @charlesBochet
  • Remove the unused upgradeApplication mutation (#30565) by @charlesBochet
  • Add TAB and SECTION navigation menu items (#30566) by @thomtrp
  • Show sidebar tabs and sections behind a feature flag (#30612) by @thomtrp
  • feat(cli): round-trip frontend component source dependencies (#30613) by @Weiko
  • Expose a calendar channel's connected account (#30618) by @ehconitin
  • Add the READ_PRIVATE_CHANNELS permission flag (#30619) by @ehconitin
  • Let an app read every calendar channel with its owner (#30624) by @ehconitin
  • fix(cli): clarify local startup login guidance (#30625) by @Weiko
  • Let a view sort order by one field of its related record (#30657) by @FelixMalfait
  • [BREAKING_CHANGE] Remove the dead SEE_VERSION_WORKFLOW_RUN engine command (#30664) by @thomtrp
  • feat(cli): round-trip logic function sources and local imports (#30665) by @Weiko
  • Store built-in sidebar sections as sections with a builtInSectionKey (#30701) by @thomtrp
  • chore: bump version to 2.61.0 (#30737) by @twenty-pr
  • Read application requestedRoleId instead of defaultRoleId (#30738) by @prastoin
  • Declare app prices in the application billing block (#30745) by @martmull
  • Add private agents (#30772) by @Weiko
  • [BREAKING_CHANGE] Add the APPLICATION billing product key and make the product plan key nullable (#30773) by @martmull
  • Bill application prices as items of the workspace subscription (#30781) by @martmull
  • fix(cli): bound external dev watch observation (#30789) by @Weiko
  • feat(cli): inspect app dev watch scope with --verbose (#30790) by @Weiko
  • [BREAKING_CHANGE] Remove the metered billing catalog API and the priceUsageBased product metadata (#30798) by @etiennejouan
  • Add push subscription API for inbox notifications (#30811) by @etiennejouan
  • Send web push notifications for new inbox messages (#30812) by @etiennejouan
  • Hide standard navigation menu items instead of deleting them (#30860) by @thomtrp
  • Ship MCP servers as bundled apps (#30950) by @FelixMalfait
  • Escape comment delimiters in the generated SDK client and keep its bundle in the generated directory (#31005) by @prastoin
  • Sync personal roles and channel visibility rules behind the channel visibility flag (#31081) by @charlesBochet
  • chore(ui): declare vite as a devDependency of twenty-ui (#31083) by @mabdullahabaid
  • Count connected members per app on the server and revoke in one statement (#31089) by @FelixMalfait
  • Make permission tables the only storage for record shares and access groups (#31091) by @charlesBochet
  • chore: replace the nx executors removed in nx 24 with nx:run-commands (#31106) by @mabdullahabaid
  • Return only the invite page fields from findWorkspaceFromInviteHash (#31108) by @prastoin
  • Let row-level permission predicates read member values through a relation (#31123) by @charlesBochet
  • Send the server's read decision to the front as canReadSomeRecords (#31144) by @charlesBochet

Full Changelog: sdk/v2.59.0...sdk/v2.61.0

Don't miss a new twenty release

NewReleases is sending notifications on new releases.