feat: Zoho Calendar

.env.appStore.example

@@ -125,4 +125,5 @@ SALESFORCE_CONSUMER_SECRET=""
 ZOHOCRM_CLIENT_ID=""
 ZOHOCRM_CLIENT_SECRET=""
 
+
 # *********************************************************************************************************

README.md

@@ -504,6 +504,9 @@ For example, `Cal.com ([email protected])`.
 9. Click the "Save"/ "UPDATE" button at the bottom footer.
 10. You're good to go. Now you can easily add your ZohoCRM integration in the Cal.com settings.
 
+### Obtaining Zoho Calendar Client ID and Secret
+
+[Follow these steps](./packages/app-store/zohocalendar/)
 ### Obtaining Zoho Bigin Client ID and Secret
 
 [Follow these steps](./packages/app-store/zoho-bigin/)

packages/app-store/apps.keys-schemas.generated.ts

@@ -30,6 +30,7 @@ import { appKeysSchema as webex_zod_ts } from "./webex/zod";
 import { appKeysSchema as wordpress_zod_ts } from "./wordpress/zod";
 import { appKeysSchema as zapier_zod_ts } from "./zapier/zod";
 import { appKeysSchema as zoho_bigin_zod_ts } from "./zoho-bigin/zod";
+import { appKeysSchema as zohocalendar_zod_ts } from "./zohocalendar/zod";
 import { appKeysSchema as zohocrm_zod_ts } from "./zohocrm/zod";
 import { appKeysSchema as zoomvideo_zod_ts } from "./zoomvideo/zod";
 
@@ -62,6 +63,7 @@ export const appKeysSchemas = {
   wordpress: wordpress_zod_ts,
   zapier: zapier_zod_ts,
   "zoho-bigin": zoho_bigin_zod_ts,
+  zohocalendar: zohocalendar_zod_ts,
   zohocrm: zohocrm_zod_ts,
   zoomvideo: zoomvideo_zod_ts,
 };

packages/app-store/apps.metadata.generated.ts

@@ -70,6 +70,7 @@ import { metadata as wipemycalother__metadata_ts } from "./wipemycalother/_metad
 import wordpress_config_json from "./wordpress/config.json";
 import { metadata as zapier__metadata_ts } from "./zapier/_metadata";
 import zoho_bigin_config_json from "./zoho-bigin/config.json";
+import zohocalendar_config_json from "./zohocalendar/config.json";
 import zohocrm_config_json from "./zohocrm/config.json";
 import { metadata as zoomvideo__metadata_ts } from "./zoomvideo/_metadata";
 
@@ -142,6 +143,7 @@ export const appStoreMetadata = {
   wordpress: wordpress_config_json,
   zapier: zapier__metadata_ts,
   "zoho-bigin": zoho_bigin_config_json,
+  zohocalendar: zohocalendar_config_json,
   zohocrm: zohocrm_config_json,
   zoomvideo: zoomvideo__metadata_ts,
 };

packages/app-store/apps.schemas.generated.ts

@@ -30,6 +30,7 @@ import { appDataSchema as webex_zod_ts } from "./webex/zod";
 import { appDataSchema as wordpress_zod_ts } from "./wordpress/zod";
 import { appDataSchema as zapier_zod_ts } from "./zapier/zod";
 import { appDataSchema as zoho_bigin_zod_ts } from "./zoho-bigin/zod";
+import { appDataSchema as zohocalendar_zod_ts } from "./zohocalendar/zod";
 import { appDataSchema as zohocrm_zod_ts } from "./zohocrm/zod";
 import { appDataSchema as zoomvideo_zod_ts } from "./zoomvideo/zod";
 
@@ -62,6 +63,7 @@ export const appDataSchemas = {
   wordpress: wordpress_zod_ts,
   zapier: zapier_zod_ts,
   "zoho-bigin": zoho_bigin_zod_ts,
+  zohocalendar: zohocalendar_zod_ts,
   zohocrm: zohocrm_zod_ts,
   zoomvideo: zoomvideo_zod_ts,
 };

packages/app-store/apps.server.generated.ts

@@ -70,6 +70,7 @@ export const apiHandlers = {
   wordpress: import("./wordpress/api"),
   zapier: import("./zapier/api"),
   "zoho-bigin": import("./zoho-bigin/api"),
+  zohocalendar: import("./zohocalendar/api"),
   zohocrm: import("./zohocrm/api"),
   zoomvideo: import("./zoomvideo/api"),
 };

packages/app-store/index.ts

@@ -32,6 +32,7 @@ const appStore = {
   exchangecalendar: () => import("./exchangecalendar"),
   facetime: () => import("./facetime"),
   sylapsvideo: () => import("./sylapsvideo"),
+  zohocalendar: () => import("./zohocalendar"),
   "zoho-bigin": () => import("./zoho-bigin"),
   basecamp3: () => import("./basecamp3"),
   telegramvideo: () => import("./telegram"),

packages/app-store/zohocalendar/DESCRIPTION.md

@@ -0,0 +1,9 @@
+---
+items:
+  - ZCal1.jpg
+  - ZCal2.jpg
+  - ZCal3.jpg
+  - ZCal4.jpg
+---
+
+Zoho Calendar is an online business calendar that makes scheduling easy for you. Use this app to sync your Cal bookings with your Zoho Calendar.

packages/app-store/zohocalendar/README.md

@@ -0,0 +1,16 @@
+## Zoho Calendar
+
+### Obtaining Zoho Calendar Client ID and Secret
+
+1. Open [Zoho API Console](https://api-console.zoho.com/) and sign into your account, or create a new one.
+2. Create a "Server-based Applications", set the Redirect URL for OAuth `<Cal.com URL>/api/integrations/zohocalendar/callback` replacing Cal.com URL with the URI at which your application runs.
+4. Fill in any information you want in the "Client Details" tab
+5. Go to tab "Client Secret" tab.
+6. Now copy the Client ID and Client Secret into your app keys in the Cal.com admin panel (`<Cal.com>/settings/admin/apps`).
+7. Back in Zoho API Console, 
+8. In the "Settings" section check the "Multi-DC" option if you wish to use the same OAuth credentials for all data centers.
+9. Click the "Save"/ "UPDATE" button at the bottom footer.
+10. You're good to go. Now you can easily add your Zoho Calendar integration in the Cal.com settings at `/settings/my-account/calendars`.
+11. You can access your Zoho calendar at [https://calendar.zoho.com/](https://calendar.zoho.com/)
+
+NOTE: If you use multiple calendars with Cal, make sure you enable the toggle to prevent double-bookings across calendar. This is in `/settings/my-account/calendars`.

packages/app-store/zohocalendar/api/add.ts

@@ -0,0 +1,42 @@
+import type { NextApiRequest, NextApiResponse } from "next";
+import { stringify } from "querystring";
+
+import { WEBAPP_URL } from "@calcom/lib/constants";
+import { defaultHandler, defaultResponder } from "@calcom/lib/server";
+
+import { encodeOAuthState } from "../../_utils/encodeOAuthState";
+import getAppKeysFromSlug from "../../_utils/getAppKeysFromSlug";
+import config from "../config.json";
+import { appKeysSchema as zohoKeysSchema } from "../zod";
+
+const OAUTH_BASE_URL = "https://accounts.zoho.com/oauth/v2";
+
+async function getHandler(req: NextApiRequest, res: NextApiResponse) {
+  const appKeys = await getAppKeysFromSlug(config.slug);
+  const { client_id } = zohoKeysSchema.parse(appKeys);
+
+  const state = encodeOAuthState(req);
+
+  const params = {
+    client_id,
+    response_type: "code",
+    redirect_uri: WEBAPP_URL + "/api/integrations/zohocalendar/callback",
+    scope: [
+      "ZohoCalendar.calendar.ALL",
+      "ZohoCalendar.event.ALL",
+      "ZohoCalendar.freebusy.READ",
+      "AaaServer.profile.READ",
+    ],
+    access_type: "offline",
+    state,
+    prompt: "consent",
+  };
+
+  const query = stringify(params);
+
+  res.status(200).json({ url: `${OAUTH_BASE_URL}/auth?${query}` });
+}
+
+export default defaultHandler({
+  GET: Promise.resolve({ default: defaultResponder(getHandler) }),
+});

packages/app-store/zohocalendar/api/callback.ts

@@ -0,0 +1,76 @@
+import type { NextApiRequest, NextApiResponse } from "next";
+import { stringify } from "querystring";
+
+import { WEBAPP_URL } from "@calcom/lib/constants";
+import { getSafeRedirectUrl } from "@calcom/lib/getSafeRedirectUrl";
+import logger from "@calcom/lib/logger";
+import { defaultHandler, defaultResponder } from "@calcom/lib/server";
+
+import createOAuthAppCredential from "../../_utils/createOAuthAppCredential";
+import { decodeOAuthState } from "../../_utils/decodeOAuthState";
+import getAppKeysFromSlug from "../../_utils/getAppKeysFromSlug";
+import getInstalledAppPath from "../../_utils/getInstalledAppPath";
+import config from "../config.json";
+import type { ZohoAuthCredentials } from "../types/ZohoCalendar";
+import { appKeysSchema as zohoKeysSchema } from "../zod";
+
+const log = logger.getChildLogger({ prefix: [`[[zohocalendar/api/callback]`] });
+
+const OAUTH_BASE_URL = "https://accounts.zoho.com/oauth/v2";
+
+async function getHandler(req: NextApiRequest, res: NextApiResponse) {
+  const { code } = req.query;
+  const state = decodeOAuthState(req);
+
+  if (code && typeof code !== "string") {
+    res.status(400).json({ message: "`code` must be a string" });
+    return;
+  }
+
+  if (!req.session?.user?.id) {
+    return res.status(401).json({ message: "You must be logged in to do this" });
+  }
+
+  const appKeys = await getAppKeysFromSlug(config.slug);
+  const { client_id, client_secret } = zohoKeysSchema.parse(appKeys);
+
+  const params = {
+    client_id,
+    grant_type: "authorization_code",
+    client_secret,
+    redirect_uri: `${WEBAPP_URL}/api/integrations/${config.slug}/callback`,
+    code,
+  };
+
+  const query = stringify(params);
+
+  const response = await fetch(`${OAUTH_BASE_URL}/token?${query}`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json; charset=utf-8",
+    },
+  });
+
+  const responseBody = await response.json();
+
+  if (!response.ok || responseBody.error) {
+    log.error("get access_token failed", responseBody);
+    return res.redirect("/apps/installed?error=" + JSON.stringify(responseBody));
+  }
+
+  const key: ZohoAuthCredentials = {
+    access_token: responseBody.access_token,
+    refresh_token: responseBody.refresh_token,
+    expires_in: Math.round(+new Date() / 1000 + responseBody.expires_in),
+  };
+
+  await createOAuthAppCredential({ appId: config.slug, type: config.type }, key, req);
+
+  res.redirect(
+    getSafeRedirectUrl(state?.returnTo) ?? getInstalledAppPath({ variant: config.variant, slug: config.slug })
+  );
+}
+
+export default defaultHandler({
+  GET: Promise.resolve({ default: defaultResponder(getHandler) }),
+});

packages/app-store/zohocalendar/api/index.ts

@@ -0,0 +1,2 @@
+export { default as add } from "./add";
+export { default as callback } from "./callback";

packages/app-store/zohocalendar/config.json

@@ -0,0 +1,16 @@
+{
+    "name": "Zoho Calendar",
+    "description": "Zoho Calendar is an online business calendar that makes scheduling easy for you. You can use it to stay on top of your schedule and also share calendars with your team to keep everyone on the same page.",
+    "slug": "zohocalendar",
+    "type": "zoho_calendar",
+    "title": "Zoho Calendar",
+    "variant": "calendar",
+    "category": "calendar",
+    "categories": [
+        "calendar"
+    ],
+    "logo": "icon.svg",
+    "publisher": "Cal.com",
+    "url": "https://cal.com/",
+    "email": "[email protected]"
+}

packages/app-store/zohocalendar/index.ts

@@ -0,0 +1,2 @@
+export * as api from "./api";
+export * as lib from "./lib";