Dhairyashil ShindeandGitHub
3ee24586a7
* feat(api): PATCH Event Type V2 API to support all current locations * docs(api): update locations documentation and add E2E tests for new integrations - Updated locations property documentation in create-event-type.input.ts and update-event-type.input.ts to clarify app installation requirements - Explained that only Google Meet, MS Teams, and Zoom can be installed via API - Noted that Cal Video is installed by default - Added E2E tests for creating and updating event types with newly supported integration locations (jitsi, zoom, google-meet, whereby, huddle, element-call) - Regenerated openapi.json with updated API documentation Addresses feedback from Lauris regarding platform API location support. * fix(api): use supportedIntegrations list for app validation Updated checkAppIsValidAndConnected to use the full supportedIntegrations list from locations.input.ts instead of hardcoded array. This allows all 27 supported conferencing apps to be set as event type locations via API, as long as they are already connected by the user. * fix(api): add slug mapping for all conferencing integrations Added comprehensive slug mapping to translate API integration names (e.g., 'facetime-video', 'whereby-video') to actual app slugs (e.g., 'facetime', 'whereby'). This ensures the app lookup works correctly for all 27 supported conferencing integrations. Addresses AI bot feedback about slug mismatches. * fix(api): add missing huddle to huddle01 slug mapping Added mapping for huddle -> huddle01. Other apps like tandem, jitsi, cal-video, google-meet, and zoom don't need mapping as their API names already match their app slugs (handled by the fallback || appSlug). * update key * update ket * test(api): update E2E tests to validate newly supported integrations Replaced end-to-end tests with validation-focused tests that follow the existing pattern. The new test creates event types with various newly supported integrations (jitsi, whereby-video, huddle, tandem, element-call-video) directly in the database (bypassing app connection checks) and verifies the API correctly returns them. This approach tests that the input validation accepts all 27 supported integration types without requiring actual app installations in the test environment. * fix(api): correct slug mappings for whatsapp, shimmer, and jelly integrations - Fixed whatsapp-video mapping from 'whatsappvideo' to 'whatsapp' - Fixed shimmer-video mapping from 'shimmer' to 'shimmervideo' - Fixed jelly-conferencing mapping from 'jelly-conferencing' to 'jelly' All slug mappings now correctly match the actual app slugs in packages/app-store/*/config.json files. This ensures proper app validation when users create/update event types with these locations. Addresses feedback from @pedroccastro * updated openapi.json file because of main branch code * test(api): add negative test for unsupported integration locations - Added E2E test to validate 400 error when creating event type with unsupported integration - Test verifies exact error message listing all supported integrations - Uses imported supportedIntegrations constant for maintainability - Follows same pattern as booking fields validation tests Addresses feedback from @supalarry * test(api): add negative test for patching event type with unconnected integration - Added E2E test to validate 400 error when user tries to PATCH event type with jitsi integration they haven't connected - Test verifies exact error message 'jitsi not connected.' - Follows existing test patterns with proper cleanup
A progressive Node.js framework for building efficient and scalable server-side applications.
Description
Cal.com is using the Nest framework TypeScript starter repository.
Installation
$ yarn install
Prisma setup
$ yarn prisma generate
Env setup
Copy .env.example to .env and fill values.
Add license Key to Deployment table in DB
id, logo, theme, licenseKey, agreedLicenseAt:- 1, null, null, '00000000-0000-0000-0000-000000000000', '2023-05-15 21:39:47.611'
Replace with your actual license key.
your CALCOM_LICENSE_KEY env var need to contain the same value
.env CALCOM_LICENSE_KEY=00000000-0000-0000-0000-000000000000
Running the app
Development
$ yarn run start
OR if you don't want to use docker, you can run following command.
$ yarn dev:no-docker
Additionally you can run following command(in different terminal) to ensure that any change in any of the dependencies is rebuilt and detected. It watches platform-libraries, platform-constants, platform-enums, platform-utils, platform-types.
$ yarn run dev:build:watch
If you are making changes in packages/platform/libraries, you should run the following command too that would connect your local packages/platform/libraries to the api/v2
$ yarn local
watch mode
$ yarn run start:dev
production mode
$ yarn run start:prod
## Test
```bash
# unit tests
$ yarn run test
# e2e tests
$ yarn run test:e2e
# e2e tests in watch mode
$ yarn test:e2e:watch
# run specific e2e test file in watch mode
$ yarn test:e2e:watch --testPathPattern=filePath
# test coverage
$ yarn run test:cov
Conventions
Guards
- In case a guard would return "false" for "canActivate" instead throw ForbiddenException with an error message containing guard name and the error.
- In case a guard would return "false" for "canActivate" DO NOT cache the result in redis, because we don't want that someone is forbidden, updates whatever was the problem, and then has to wait for cache to expire. We only cache in redis guard results where "canAccess" is "true".
- If you use ApiAuthGuard but want that only specific auth method is allowed, for example, api key, then you also need to add
@ApiAuthGuardOnlyAllow(["API_KEY"])under the@UseGuards(ApiAuthGuard). Shortly, useApiAuthGuardOnlyAllowto specify which auth methods are allowed byApiAuthGuard. IfApiAuthGuardOnlyAllowis not used or nothing is passed to it or empty array it means that all auth methods are allowed.
Support
Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please read more here.
Stay in touch
- Author - Kamil Myśliwiec
- Website - https://nestjs.com
- Twitter - @nestframework
License
Nest is MIT licensed.