@friggframework/api-module-zoho-crm 2.0.0-next.3 → 2.0.0-next.4

package/dist/api.d.ts

@@ -1,12 +1,24 @@
 import { OAuth2Requester } from '@friggframework/core';
-import { ZohoConfig, QueryParams, SearchParams, UsersResponse, RolesResponse, ProfilesResponse, ContactsResponse, ContactResponse, LeadsResponse, LeadResponse, AccountsResponse, AccountResponse, TokenResponse, CreateNoteData, NotesResponse, NoteListResponse, NotificationWatchConfig, NotificationResponse, NotificationDetailsResponse, ZohoCallData, CallsResponse } from './types';
+import { ZohoConfig, ZohoLocation, QueryParams, SearchParams, UsersResponse, RolesResponse, ProfilesResponse, ContactsResponse, ContactResponse, LeadsResponse, LeadResponse, AccountsResponse, AccountResponse, TokenResponse, CreateNoteData, NotesResponse, NoteListResponse, NotificationWatchConfig, NotificationResponse, NotificationDetailsResponse, ZohoCallData, CallsResponse } from './types';
 export declare class Api extends OAuth2Requester {
     URLs: Record<string, string | ((id: string) => string)>;
+    location: ZohoLocation;
+    accountsServer: string | null;
     private static readonly CONTACTS_DEFAULT_FIELDS;
     private static readonly LEADS_DEFAULT_FIELDS;
     private static readonly ACCOUNTS_DEFAULT_FIELDS;
     constructor(params: ZohoConfig);
     getAuthUri(): string;
+    /**
+     * Sets the datacenter location and updates URLs accordingly.
+     * Note: tokenUri is only updated if accountsServer is not set.
+     */
+    setLocation(location: ZohoLocation): void;
+    /**
+     * Sets the accounts server URL for token operations.
+     * Call this when accounts-server is provided in OAuth callback.
+     */
+    setAccountsServer(accountsServer: string): void;
     getTokenFromCode(code: string): Promise<TokenResponse>;
     _delete(options: any): Promise<any>;
     /**

package/dist/api.js

@@ -3,12 +3,35 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Api = void 0;
 const FormData = require("form-data");
 const core_1 = require("@friggframework/core");
+/**
+ * Zoho datacenter URL configuration
+ * @see https://www.zoho.com/crm/developer/docs/api/v8/multi-dc.html
+ */
+const LOCATION_CONFIG = {
+    us: { accounts: 'https://accounts.zoho.com', api: 'https://www.zohoapis.com' },
+    eu: { accounts: 'https://accounts.zoho.eu', api: 'https://www.zohoapis.eu' },
+    in: { accounts: 'https://accounts.zoho.in', api: 'https://www.zohoapis.in' },
+    au: { accounts: 'https://accounts.zoho.com.au', api: 'https://www.zohoapis.com.au' },
+    cn: { accounts: 'https://accounts.zoho.com.cn', api: 'https://www.zohoapis.com.cn' },
+    ca: { accounts: 'https://accounts.zoho.ca', api: 'https://www.zohoapis.ca' },
+    jp: { accounts: 'https://accounts.zoho.jp', api: 'https://www.zohoapis.jp' },
+    sa: { accounts: 'https://accounts.zoho.sa', api: 'https://www.zohoapis.sa' },
+};
+const DEFAULT_LOCATION = 'us';
 class Api extends core_1.OAuth2Requester {
     constructor(params) {
         super(params);
-        this.baseUrl = 'https://www.zohoapis.com/crm/v8';
-        this.authorizationUri = encodeURI(`https://accounts.zoho.com/oauth/v2/auth?scope=${this.scope}&client_id=${this.client_id}&redirect_uri=${this.redirect_uri}&response_type=code&access_type=offline`);
-        this.tokenUri = 'https://accounts.zoho.com/oauth/v2/token';
+        this.accountsServer = (0, core_1.get)(params, 'accountsServer', null);
+        this.location = (0, core_1.get)(params, 'location', DEFAULT_LOCATION);
+        if (!LOCATION_CONFIG[this.location]) {
+            this.location = DEFAULT_LOCATION;
+        }
+        const locationConfig = LOCATION_CONFIG[this.location];
+        this.baseUrl = `${locationConfig.api}/crm/v8`;
+        this.tokenUri = this.accountsServer
+            ? `${this.accountsServer}/oauth/v2/token`
+            : `${locationConfig.accounts}/oauth/v2/token`;
+        this.authorizationUri = encodeURI(`${locationConfig.accounts}/oauth/v2/auth?scope=${this.scope}&client_id=${this.client_id}&redirect_uri=${this.redirect_uri}&response_type=code&access_type=offline`);
         this.access_token = (0, core_1.get)(params, 'access_token', null);
         this.refresh_token = (0, core_1.get)(params, 'refresh_token', null);
         this.URLs = {
@@ -34,6 +57,30 @@ class Api extends core_1.OAuth2Requester {
     getAuthUri() {
         return this.authorizationUri;
     }
+    /**
+     * Sets the datacenter location and updates URLs accordingly.
+     * Note: tokenUri is only updated if accountsServer is not set.
+     */
+    setLocation(location) {
+        if (!LOCATION_CONFIG[location]) {
+            throw new Error(`Invalid Zoho location: ${location}. Must be one of: ${Object.keys(LOCATION_CONFIG).join(', ')}`);
+        }
+        this.location = location;
+        const locationConfig = LOCATION_CONFIG[location];
+        this.baseUrl = `${locationConfig.api}/crm/v8`;
+        if (!this.accountsServer) {
+            this.tokenUri = `${locationConfig.accounts}/oauth/v2/token`;
+        }
+        this.authorizationUri = encodeURI(`${locationConfig.accounts}/oauth/v2/auth?scope=${this.scope}&client_id=${this.client_id}&redirect_uri=${this.redirect_uri}&response_type=code&access_type=offline`);
+    }
+    /**
+     * Sets the accounts server URL for token operations.
+     * Call this when accounts-server is provided in OAuth callback.
+     */
+    setAccountsServer(accountsServer) {
+        this.accountsServer = accountsServer;
+        this.tokenUri = `${accountsServer}/oauth/v2/token`;
+    }
     async getTokenFromCode(code) {
         const formData = new FormData();
         formData.append('grant_type', 'authorization_code');

package/dist/definition.d.ts

@@ -7,7 +7,7 @@ export declare const Definition: {
         getToken: (api: Api, params: any) => Promise<void>;
         apiPropertiesToPersist: {
             credential: string[];
-            entity: never[];
+            entity: string[];
         };
         getCredentialDetails: (api: Api, userId: string) => Promise<any>;
         getEntityDetails: (api: Api, callbackParams: any, tokenResponse: any, userId: string) => Promise<any>;

package/dist/definition.js

@@ -38,11 +38,19 @@ exports.Definition = {
     requiredAuthMethods: {
         getToken: async function (api, params) {
             const code = (0, core_1.get)(params, 'code');
+            const location = (0, core_1.get)(params, 'location', null);
+            const accountsServer = (0, core_1.get)(params, 'accounts-server', null);
+            if (location) {
+                api.setLocation(location);
+            }
+            if (accountsServer) {
+                api.setAccountsServer(accountsServer);
+            }
             await api.getTokenFromCode(code);
         },
         apiPropertiesToPersist: {
             credential: ['access_token', 'refresh_token'],
-            entity: [],
+            entity: ['location', 'accountsServer'],
         },
         getCredentialDetails: async function (api, userId) {
             const response = await api.listUsers({ type: 'CurrentUser' });
@@ -58,7 +66,9 @@ exports.Definition = {
             return {
                 identifiers: { externalId: currentUser.id, user: userId },
                 details: {
-                    name: currentUser.email
+                    name: currentUser.email,
+                    location: api.location,
+                    accountsServer: api.accountsServer,
                 },
             };
         },

package/dist/types.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Zoho datacenter locations
+ * @see https://www.zoho.com/crm/developer/docs/api/v8/multi-dc.html
+ */
+export type ZohoLocation = 'us' | 'eu' | 'in' | 'au' | 'cn' | 'ca' | 'jp' | 'sa';
 export interface ZohoConfig {
     client_id: string;
     client_secret: string;
@@ -5,6 +10,8 @@ export interface ZohoConfig {
     redirect_uri: string;
     access_token?: string | null;
     refresh_token?: string | null;
+    location?: ZohoLocation;
+    accountsServer?: string | null;
 }
 export interface PaginationInfo {
     per_page: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@friggframework/api-module-zoho-crm",
-  "version": "2.0.0-next.3",
+  "version": "2.0.0-next.4",
   "prettier": "@friggframework/prettier-config",
   "description": "Zoho CRM API module that lets the Frigg Framework interact with Zoho CRM",
   "main": "dist/index.js",
@@ -21,8 +21,8 @@
   "author": "",
   "license": "MIT",
   "devDependencies": {
-    "@friggframework/devtools": "^2.0.0-next.16",
-    "@friggframework/test": "^2.0.0-next.16",
+    "@friggframework/devtools": "^2.0.0-next.68",
+    "@friggframework/test": "^2.0.0-next.68",
     "@types/node": "^20.8.0",
     "dotenv": "^16.0.3",
     "eslint": "^8.22.0",
@@ -31,10 +31,10 @@
     "vitest": "^1.0.0"
   },
   "dependencies": {
-    "@friggframework/core": "^2.0.0-next.16"
+    "@friggframework/core": "^2.0.0-next.68"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "fd8e7d7ad197886b7bd94a68fd26c179358f4b67"
+  "gitHead": "e067a887c7a7674018dc7e47bcf02a684400de70"
 }