@dereekb/zoho 12.1.12 → 12.1.13

package/index.cjs.js

@@ -1741,40 +1741,6 @@ $$2({ target: 'Iterator', proto: true, real: true }, {
   }
 });
 
-var call$2 = functionCall;
-var aCallable$1 = aCallable$7;
-var anObject$2 = anObject$e;
-var getIteratorDirect$2 = getIteratorDirect$5;
-var createIteratorProxy$1 = iteratorCreateProxy;
-var callWithSafeIterationClosing = callWithSafeIterationClosing$2;
-
-var IteratorProxy$1 = createIteratorProxy$1(function () {
-  var iterator = this.iterator;
-  var result = anObject$2(call$2(this.next, iterator));
-  var done = this.done = !!result.done;
-  if (!done) return callWithSafeIterationClosing(iterator, this.mapper, [result.value, this.counter++], true);
-});
-
-// `Iterator.prototype.map` method
-// https://github.com/tc39/proposal-iterator-helpers
-var iteratorMap = function map(mapper) {
-  anObject$2(this);
-  aCallable$1(mapper);
-  return new IteratorProxy$1(getIteratorDirect$2(this), {
-    mapper: mapper
-  });
-};
-
-var $$1 = _export;
-var map = iteratorMap;
-var IS_PURE$1 = isPure;
-
-// `Iterator.prototype.map` method
-// https://github.com/tc39/proposal-iterator-helpers
-$$1({ target: 'Iterator', proto: true, real: true, forced: IS_PURE$1 }, {
-  map: map
-});
-
 /**
  * Returns an empty ZohoPageResult that is typed to R and has no more records/results.
  */
@@ -1828,40 +1794,61 @@ function zohoRecruitConfigApiUrl(input) {
   }
 }
 
-var call$1 = functionCall;
-var anObject$1 = anObject$e;
-var getIteratorDirect$1 = getIteratorDirect$5;
+/**
+ * Candidates module name
+ */
+const ZOHO_RECRUIT_CANDIDATES_MODULE = 'Candidates';
+/**
+ * Job Openings module name
+ */
+const ZOHO_RECRUIT_JOB_OPENINGS_MODULE = 'Job_Openings';
+/**
+ * Notes module name
+ */
+const ZOHO_RECRUIT_NOTES_MODULE = 'Notes';
+/**
+ * Emails module name
+ */
+const ZOHO_RECRUIT_EMAILS_MODULE = 'Emails';
+/**
+ * Returns true if it is a valid ZohoRecruitValidUrl.
+ */
+const isZohoRecruitValidUrl = util.isStandardInternetAccessibleWebsiteUrl;
+
+var call$2 = functionCall;
+var anObject$2 = anObject$e;
+var getIteratorDirect$2 = getIteratorDirect$5;
 var getIteratorMethod = getIteratorMethod$3;
 
 var getIteratorFlattenable$1 = function (obj, stringHandling) {
-  if (!stringHandling || typeof obj !== 'string') anObject$1(obj);
+  if (!stringHandling || typeof obj !== 'string') anObject$2(obj);
   var method = getIteratorMethod(obj);
-  return getIteratorDirect$1(anObject$1(method !== undefined ? call$1(method, obj) : obj));
+  return getIteratorDirect$2(anObject$2(method !== undefined ? call$2(method, obj) : obj));
 };
 
-var $ = _export;
-var call = functionCall;
-var aCallable = aCallable$7;
-var anObject = anObject$e;
-var getIteratorDirect = getIteratorDirect$5;
+var $$1 = _export;
+var call$1 = functionCall;
+var aCallable$1 = aCallable$7;
+var anObject$1 = anObject$e;
+var getIteratorDirect$1 = getIteratorDirect$5;
 var getIteratorFlattenable = getIteratorFlattenable$1;
-var createIteratorProxy = iteratorCreateProxy;
+var createIteratorProxy$1 = iteratorCreateProxy;
 var iteratorClose = iteratorClose$4;
-var IS_PURE = isPure;
+var IS_PURE$1 = isPure;
 
-var IteratorProxy = createIteratorProxy(function () {
+var IteratorProxy$1 = createIteratorProxy$1(function () {
   var iterator = this.iterator;
   var mapper = this.mapper;
   var result, inner;
 
   while (true) {
     if (inner = this.inner) try {
-      result = anObject(call(inner.next, inner.iterator));
+      result = anObject$1(call$1(inner.next, inner.iterator));
       if (!result.done) return result.value;
       this.inner = null;
     } catch (error) { iteratorClose(iterator, 'throw', error); }
 
-    result = anObject(call(this.next, iterator));
+    result = anObject$1(call$1(this.next, iterator));
 
     if (this.done = !!result.done) return;
 
@@ -1873,17 +1860,51 @@ var IteratorProxy = createIteratorProxy(function () {
 
 // `Iterator.prototype.flatMap` method
 // https://github.com/tc39/proposal-iterator-helpers
-$({ target: 'Iterator', proto: true, real: true, forced: IS_PURE }, {
+$$1({ target: 'Iterator', proto: true, real: true, forced: IS_PURE$1 }, {
   flatMap: function flatMap(mapper) {
-    anObject(this);
-    aCallable(mapper);
-    return new IteratorProxy(getIteratorDirect(this), {
+    anObject$1(this);
+    aCallable$1(mapper);
+    return new IteratorProxy$1(getIteratorDirect$1(this), {
       mapper: mapper,
       inner: null
     });
   }
 });
 
+var call = functionCall;
+var aCallable = aCallable$7;
+var anObject = anObject$e;
+var getIteratorDirect = getIteratorDirect$5;
+var createIteratorProxy = iteratorCreateProxy;
+var callWithSafeIterationClosing = callWithSafeIterationClosing$2;
+
+var IteratorProxy = createIteratorProxy(function () {
+  var iterator = this.iterator;
+  var result = anObject(call(this.next, iterator));
+  var done = this.done = !!result.done;
+  if (!done) return callWithSafeIterationClosing(iterator, this.mapper, [result.value, this.counter++], true);
+});
+
+// `Iterator.prototype.map` method
+// https://github.com/tc39/proposal-iterator-helpers
+var iteratorMap = function map(mapper) {
+  anObject(this);
+  aCallable(mapper);
+  return new IteratorProxy(getIteratorDirect(this), {
+    mapper: mapper
+  });
+};
+
+var $ = _export;
+var map = iteratorMap;
+var IS_PURE = isPure;
+
+// `Iterator.prototype.map` method
+// https://github.com/tc39/proposal-iterator-helpers
+$({ target: 'Iterator', proto: true, real: true, forced: IS_PURE }, {
+  map: map
+});
+
 /**
  * Can search up to 10 criteria at a time.
  *
@@ -2449,50 +2470,19 @@ function searchRecordsPageFactory(context) {
 function getRelatedRecordsFunctionFactory(context) {
   return config => {
     const {
-      targetModule
+      targetModule,
+      returnEmptyRecordsInsteadOfNull = true
     } = config;
-    return input => context.fetchJson(`/v2/${input.module}/${input.id}/${targetModule}?${zohoRecruitUrlSearchParamsMinusIdAndModule(input, input.filter).toString()}`, zohoRecruitApiFetchJsonInput('GET'));
+    return input => context.fetchJson(`/v2/${input.module}/${input.id}/${targetModule}?${zohoRecruitUrlSearchParamsMinusIdAndModule(input, input.filter).toString()}`, zohoRecruitApiFetchJsonInput('GET')).then(x => x ?? (returnEmptyRecordsInsteadOfNull !== false ? emptyZohoPageResult() : x));
   };
 }
-function createNotes(context) {
-  return input => context.fetchJson(`/v2/Notes`, zohoRecruitApiFetchJsonInput('POST', {
-    data: input.data
-  })).then(x => {
-    return zohoRecruitMultiRecordResult(util.asArray(input.data), x.data);
-  });
-}
-function deleteNotes(context) {
-  return input => context.fetchJson(`/v2/Notes?${fetch.makeUrlSearchParams({
-    ids: input.ids
-  })}`, zohoRecruitApiFetchJsonInput('DELETE')).then(x => {
-    return zohoRecruitMultiRecordResult(util.asArray(input.ids), x.data);
-  });
-}
-function getNotesForRecord(context) {
+function getEmailsForRecord(context) {
   return getRelatedRecordsFunctionFactory(context)({
-    targetModule: 'Notes'
+    targetModule: ZOHO_RECRUIT_EMAILS_MODULE
   });
 }
-function getNotesForRecordPageFactory(context) {
-  return zohoFetchPageFactory(getNotesForRecord(context));
-}
-function createNotesForRecord(context) {
-  const createNotesInstance = createNotes(context);
-  return input => {
-    const {
-      module: se_module,
-      id: Parent_Id,
-      notes
-    } = input;
-    const createNotesRequest = {
-      data: util.asArray(notes).map(x => ({
-        ...x,
-        se_module,
-        Parent_Id
-      }))
-    };
-    return createNotesInstance(createNotesRequest);
-  };
+function getEmailsForRecordPageFactory(context) {
+  return zohoFetchPageFactory(getEmailsForRecord(context));
 }
 class ZohoRecruitExecuteRestApiFunctionError extends makeError.BaseError {
   constructor(error) {
@@ -2596,19 +2586,6 @@ function zohoRecruitMultiRecordResult(input, results) {
   return result;
 }
 
-/**
- * Candidates module name
- */
-const ZOHO_RECRUIT_CANDIDATES_MODULE = 'Candidates';
-/**
- * Job Openings module name
- */
-const ZOHO_RECRUIT_JOB_OPENINGS_MODULE = 'Job_Openings';
-/**
- * Returns true if it is a valid ZohoRecruitValidUrl.
- */
-const isZohoRecruitValidUrl = util.isStandardInternetAccessibleWebsiteUrl;
-
 /**
  * Associates one or more candidates with one or more job openings.
  *
@@ -2670,6 +2647,109 @@ function searchJobOpeningAssociatedCandidateRecordsPageFactory(context) {
   return zohoFetchPageFactory(searchJobOpeningAssociatedCandidateRecords(context));
 }
 
+function createNotes(context) {
+  return input => context.fetchJson(`/v2/${ZOHO_RECRUIT_NOTES_MODULE}`, zohoRecruitApiFetchJsonInput('POST', {
+    data: input.data
+  })).then(x => {
+    return zohoRecruitMultiRecordResult(util.asArray(input.data), x.data);
+  });
+}
+function deleteNotes(context) {
+  return input => context.fetchJson(`/v2/${ZOHO_RECRUIT_NOTES_MODULE}?${fetch.makeUrlSearchParams({
+    ids: input.ids
+  })}`, zohoRecruitApiFetchJsonInput('DELETE')).then(x => {
+    return zohoRecruitMultiRecordResult(util.asArray(input.ids), x.data);
+  });
+}
+function getNotesForRecord(context) {
+  return getRelatedRecordsFunctionFactory(context)({
+    targetModule: ZOHO_RECRUIT_NOTES_MODULE
+  });
+}
+function getNotesForRecordPageFactory(context) {
+  return zohoFetchPageFactory(getNotesForRecord(context));
+}
+function createNotesForRecord(context) {
+  const createNotesInstance = createNotes(context);
+  return input => {
+    const {
+      module: se_module,
+      id: Parent_Id,
+      notes
+    } = input;
+    const createNotesRequest = {
+      data: util.asArray(notes).map(x => ({
+        ...x,
+        se_module,
+        Parent_Id
+      }))
+    };
+    return createNotesInstance(createNotesRequest);
+  };
+}
+
+function createTagsForModule(context) {
+  return input => context.fetchJson(`/v2/settings/tags?${fetch.makeUrlSearchParams({
+    module: input.module
+  })}`, zohoRecruitApiFetchJsonInput('POST', {
+    tags: util.asArray(input.tags)
+  })).then(x => {
+    const result = zohoRecruitMultiRecordResult(util.asArray(input.tags), x.tags);
+    const {
+      included: duplicateErrorItems,
+      excluded: otherErrorItems
+    } = util.separateValues(result.errorItems, x => {
+      return x.result.code === ZOHO_DUPLICATE_DATA_ERROR_CODE;
+    });
+    return {
+      ...result,
+      errorItems: otherErrorItems,
+      duplicateErrorItems,
+      allErrorItems: result.errorItems
+    };
+  });
+}
+/**
+ * Returns the list of tags within a module.
+ *
+ * https://www.zoho.com/recruit/developer-guide/apiv2/get-tag-list.html
+ *
+ * @param context
+ * @returns
+ */
+function getTagsForModule(context) {
+  return input => context.fetchJson(`/v2/settings/tags?${fetch.makeUrlSearchParams({
+    module: input.module,
+    my_tags: input.my_tags
+  })}`, zohoRecruitApiFetchJsonInput('GET')).then(x => {
+    // NOTE: This doesn't follow the api documentation, and instead is a normal page result except it has "tags" instead of "data".
+    return {
+      ...x,
+      data: x.tags
+    };
+  });
+}
+function getTagsForModulePageFactory(context) {
+  return zohoFetchPageFactory(getTagsForModule(context));
+}
+/**
+ * Associates one or more candidates with one or more job openings.
+ *
+ * https://www.zoho.com/recruit/developer-guide/apiv2/associate-candidate.html
+ *
+ * @param context
+ * @returns
+ */
+function addTagsToRecords(context) {
+  return input => context.fetchJson(`/v2/${ZOHO_RECRUIT_CANDIDATES_MODULE}/actions/add_tags?${fetch.makeUrlSearchParams({
+    tag_names: input.tag_names,
+    ids: input.ids
+  })}`, zohoRecruitApiFetchJsonInput('POST')).then(x => {
+    const resultInputMap = x.data.map(() => input); // assign "input" to each value for now
+    return zohoRecruitMultiRecordResult(resultInputMap, x.data);
+  });
+}
+
 /**
  * Creates a ZohoRecruitSearchRecordsCriteriaEntryArray from an array of emails.
  *
@@ -2868,6 +2948,11 @@ function zohoRecruitFactory(factoryConfig) {
   };
 }
 
+/**
+ * Maximum length of ZohoRecruitTagName
+ */
+const ZOHO_RECRUIT_TAG_NAME_MAX_LENGTH = 25;
+
 /**
  * Trades a refresh token for a new AccessToken
  * @param context
@@ -3056,8 +3141,11 @@ exports.ZOHO_RATE_LIMIT_REMAINING_HEADER = ZOHO_RATE_LIMIT_REMAINING_HEADER;
 exports.ZOHO_RATE_LIMIT_RESET_HEADER = ZOHO_RATE_LIMIT_RESET_HEADER;
 exports.ZOHO_RECRUIT_ALREADY_ASSOCIATED_ERROR_CODE = ZOHO_RECRUIT_ALREADY_ASSOCIATED_ERROR_CODE;
 exports.ZOHO_RECRUIT_CANDIDATES_MODULE = ZOHO_RECRUIT_CANDIDATES_MODULE;
+exports.ZOHO_RECRUIT_EMAILS_MODULE = ZOHO_RECRUIT_EMAILS_MODULE;
 exports.ZOHO_RECRUIT_JOB_OPENINGS_MODULE = ZOHO_RECRUIT_JOB_OPENINGS_MODULE;
+exports.ZOHO_RECRUIT_NOTES_MODULE = ZOHO_RECRUIT_NOTES_MODULE;
 exports.ZOHO_RECRUIT_SERVICE_NAME = ZOHO_RECRUIT_SERVICE_NAME;
+exports.ZOHO_RECRUIT_TAG_NAME_MAX_LENGTH = ZOHO_RECRUIT_TAG_NAME_MAX_LENGTH;
 exports.ZOHO_SUCCESS_CODE = ZOHO_SUCCESS_CODE;
 exports.ZOHO_SUCCESS_STATUS = ZOHO_SUCCESS_STATUS;
 exports.ZOHO_TOO_MANY_REQUESTS_ERROR_CODE = ZOHO_TOO_MANY_REQUESTS_ERROR_CODE;
@@ -3078,20 +3166,26 @@ exports.ZohoServerError = ZohoServerError;
 exports.ZohoServerFetchResponseError = ZohoServerFetchResponseError;
 exports.ZohoTooManyRequestsError = ZohoTooManyRequestsError;
 exports.accessToken = accessToken;
+exports.addTagsToRecords = addTagsToRecords;
 exports.assertRecordDataArrayResultHasContent = assertRecordDataArrayResultHasContent;
 exports.associateCandidateRecordsWithJobOpenings = associateCandidateRecordsWithJobOpenings;
 exports.createNotes = createNotes;
 exports.createNotesForRecord = createNotesForRecord;
+exports.createTagsForModule = createTagsForModule;
 exports.deleteNotes = deleteNotes;
 exports.deleteRecord = deleteRecord;
 exports.emptyZohoPageResult = emptyZohoPageResult;
 exports.escapeZohoFieldValueForCriteriaString = escapeZohoFieldValueForCriteriaString;
 exports.executeRestApiFunction = executeRestApiFunction;
+exports.getEmailsForRecord = getEmailsForRecord;
+exports.getEmailsForRecordPageFactory = getEmailsForRecordPageFactory;
 exports.getNotesForRecord = getNotesForRecord;
 exports.getNotesForRecordPageFactory = getNotesForRecordPageFactory;
 exports.getRecordById = getRecordById;
 exports.getRecords = getRecords;
 exports.getRelatedRecordsFunctionFactory = getRelatedRecordsFunctionFactory;
+exports.getTagsForModule = getTagsForModule;
+exports.getTagsForModulePageFactory = getTagsForModulePageFactory;
 exports.handleZohoAccountsErrorFetch = handleZohoAccountsErrorFetch;
 exports.handleZohoErrorFetchFactory = handleZohoErrorFetchFactory;
 exports.handleZohoRecruitErrorFetch = handleZohoRecruitErrorFetch;

package/index.esm.js

@@ -1,4 +1,4 @@
-import { getNextPageNumber, escapeStringCharactersFunction, filterMaybeArrayValues, asArray, MS_IN_MINUTE, isStandardInternetAccessibleWebsiteUrl, separateValues, resetPeriodPromiseRateLimiter, MS_IN_SECOND } from '@dereekb/util';
+import { getNextPageNumber, isStandardInternetAccessibleWebsiteUrl, escapeStringCharactersFunction, filterMaybeArrayValues, asArray, MS_IN_MINUTE, separateValues, resetPeriodPromiseRateLimiter, MS_IN_SECOND } from '@dereekb/util';
 import { fetchPageFactory, FetchResponseError, makeUrlSearchParams, FetchRequestFactoryError, rateLimitedFetchHandler, fetchJsonFunction, returnNullHandleFetchJsonParseErrorFunction, fetchApiFetchService } from '@dereekb/util/fetch';
 import { BaseError } from 'make-error';
 
@@ -1739,40 +1739,6 @@ $$2({ target: 'Iterator', proto: true, real: true }, {
   }
 });
 
-var call$2 = functionCall;
-var aCallable$1 = aCallable$7;
-var anObject$2 = anObject$e;
-var getIteratorDirect$2 = getIteratorDirect$5;
-var createIteratorProxy$1 = iteratorCreateProxy;
-var callWithSafeIterationClosing = callWithSafeIterationClosing$2;
-
-var IteratorProxy$1 = createIteratorProxy$1(function () {
-  var iterator = this.iterator;
-  var result = anObject$2(call$2(this.next, iterator));
-  var done = this.done = !!result.done;
-  if (!done) return callWithSafeIterationClosing(iterator, this.mapper, [result.value, this.counter++], true);
-});
-
-// `Iterator.prototype.map` method
-// https://github.com/tc39/proposal-iterator-helpers
-var iteratorMap = function map(mapper) {
-  anObject$2(this);
-  aCallable$1(mapper);
-  return new IteratorProxy$1(getIteratorDirect$2(this), {
-    mapper: mapper
-  });
-};
-
-var $$1 = _export;
-var map = iteratorMap;
-var IS_PURE$1 = isPure;
-
-// `Iterator.prototype.map` method
-// https://github.com/tc39/proposal-iterator-helpers
-$$1({ target: 'Iterator', proto: true, real: true, forced: IS_PURE$1 }, {
-  map: map
-});
-
 /**
  * Returns an empty ZohoPageResult that is typed to R and has no more records/results.
  */
@@ -1826,40 +1792,61 @@ function zohoRecruitConfigApiUrl(input) {
   }
 }
 
-var call$1 = functionCall;
-var anObject$1 = anObject$e;
-var getIteratorDirect$1 = getIteratorDirect$5;
+/**
+ * Candidates module name
+ */
+const ZOHO_RECRUIT_CANDIDATES_MODULE = 'Candidates';
+/**
+ * Job Openings module name
+ */
+const ZOHO_RECRUIT_JOB_OPENINGS_MODULE = 'Job_Openings';
+/**
+ * Notes module name
+ */
+const ZOHO_RECRUIT_NOTES_MODULE = 'Notes';
+/**
+ * Emails module name
+ */
+const ZOHO_RECRUIT_EMAILS_MODULE = 'Emails';
+/**
+ * Returns true if it is a valid ZohoRecruitValidUrl.
+ */
+const isZohoRecruitValidUrl = isStandardInternetAccessibleWebsiteUrl;
+
+var call$2 = functionCall;
+var anObject$2 = anObject$e;
+var getIteratorDirect$2 = getIteratorDirect$5;
 var getIteratorMethod = getIteratorMethod$3;
 
 var getIteratorFlattenable$1 = function (obj, stringHandling) {
-  if (!stringHandling || typeof obj !== 'string') anObject$1(obj);
+  if (!stringHandling || typeof obj !== 'string') anObject$2(obj);
   var method = getIteratorMethod(obj);
-  return getIteratorDirect$1(anObject$1(method !== undefined ? call$1(method, obj) : obj));
+  return getIteratorDirect$2(anObject$2(method !== undefined ? call$2(method, obj) : obj));
 };
 
-var $ = _export;
-var call = functionCall;
-var aCallable = aCallable$7;
-var anObject = anObject$e;
-var getIteratorDirect = getIteratorDirect$5;
+var $$1 = _export;
+var call$1 = functionCall;
+var aCallable$1 = aCallable$7;
+var anObject$1 = anObject$e;
+var getIteratorDirect$1 = getIteratorDirect$5;
 var getIteratorFlattenable = getIteratorFlattenable$1;
-var createIteratorProxy = iteratorCreateProxy;
+var createIteratorProxy$1 = iteratorCreateProxy;
 var iteratorClose = iteratorClose$4;
-var IS_PURE = isPure;
+var IS_PURE$1 = isPure;
 
-var IteratorProxy = createIteratorProxy(function () {
+var IteratorProxy$1 = createIteratorProxy$1(function () {
   var iterator = this.iterator;
   var mapper = this.mapper;
   var result, inner;
 
   while (true) {
     if (inner = this.inner) try {
-      result = anObject(call(inner.next, inner.iterator));
+      result = anObject$1(call$1(inner.next, inner.iterator));
       if (!result.done) return result.value;
       this.inner = null;
     } catch (error) { iteratorClose(iterator, 'throw', error); }
 
-    result = anObject(call(this.next, iterator));
+    result = anObject$1(call$1(this.next, iterator));
 
     if (this.done = !!result.done) return;
 
@@ -1871,17 +1858,51 @@ var IteratorProxy = createIteratorProxy(function () {
 
 // `Iterator.prototype.flatMap` method
 // https://github.com/tc39/proposal-iterator-helpers
-$({ target: 'Iterator', proto: true, real: true, forced: IS_PURE }, {
+$$1({ target: 'Iterator', proto: true, real: true, forced: IS_PURE$1 }, {
   flatMap: function flatMap(mapper) {
-    anObject(this);
-    aCallable(mapper);
-    return new IteratorProxy(getIteratorDirect(this), {
+    anObject$1(this);
+    aCallable$1(mapper);
+    return new IteratorProxy$1(getIteratorDirect$1(this), {
       mapper: mapper,
       inner: null
     });
   }
 });
 
+var call = functionCall;
+var aCallable = aCallable$7;
+var anObject = anObject$e;
+var getIteratorDirect = getIteratorDirect$5;
+var createIteratorProxy = iteratorCreateProxy;
+var callWithSafeIterationClosing = callWithSafeIterationClosing$2;
+
+var IteratorProxy = createIteratorProxy(function () {
+  var iterator = this.iterator;
+  var result = anObject(call(this.next, iterator));
+  var done = this.done = !!result.done;
+  if (!done) return callWithSafeIterationClosing(iterator, this.mapper, [result.value, this.counter++], true);
+});
+
+// `Iterator.prototype.map` method
+// https://github.com/tc39/proposal-iterator-helpers
+var iteratorMap = function map(mapper) {
+  anObject(this);
+  aCallable(mapper);
+  return new IteratorProxy(getIteratorDirect(this), {
+    mapper: mapper
+  });
+};
+
+var $ = _export;
+var map = iteratorMap;
+var IS_PURE = isPure;
+
+// `Iterator.prototype.map` method
+// https://github.com/tc39/proposal-iterator-helpers
+$({ target: 'Iterator', proto: true, real: true, forced: IS_PURE }, {
+  map: map
+});
+
 /**
  * Can search up to 10 criteria at a time.
  *
@@ -2447,50 +2468,19 @@ function searchRecordsPageFactory(context) {
 function getRelatedRecordsFunctionFactory(context) {
   return config => {
     const {
-      targetModule
+      targetModule,
+      returnEmptyRecordsInsteadOfNull = true
     } = config;
-    return input => context.fetchJson(`/v2/${input.module}/${input.id}/${targetModule}?${zohoRecruitUrlSearchParamsMinusIdAndModule(input, input.filter).toString()}`, zohoRecruitApiFetchJsonInput('GET'));
+    return input => context.fetchJson(`/v2/${input.module}/${input.id}/${targetModule}?${zohoRecruitUrlSearchParamsMinusIdAndModule(input, input.filter).toString()}`, zohoRecruitApiFetchJsonInput('GET')).then(x => x ?? (returnEmptyRecordsInsteadOfNull !== false ? emptyZohoPageResult() : x));
   };
 }
-function createNotes(context) {
-  return input => context.fetchJson(`/v2/Notes`, zohoRecruitApiFetchJsonInput('POST', {
-    data: input.data
-  })).then(x => {
-    return zohoRecruitMultiRecordResult(asArray(input.data), x.data);
-  });
-}
-function deleteNotes(context) {
-  return input => context.fetchJson(`/v2/Notes?${makeUrlSearchParams({
-    ids: input.ids
-  })}`, zohoRecruitApiFetchJsonInput('DELETE')).then(x => {
-    return zohoRecruitMultiRecordResult(asArray(input.ids), x.data);
-  });
-}
-function getNotesForRecord(context) {
+function getEmailsForRecord(context) {
   return getRelatedRecordsFunctionFactory(context)({
-    targetModule: 'Notes'
+    targetModule: ZOHO_RECRUIT_EMAILS_MODULE
   });
 }
-function getNotesForRecordPageFactory(context) {
-  return zohoFetchPageFactory(getNotesForRecord(context));
-}
-function createNotesForRecord(context) {
-  const createNotesInstance = createNotes(context);
-  return input => {
-    const {
-      module: se_module,
-      id: Parent_Id,
-      notes
-    } = input;
-    const createNotesRequest = {
-      data: asArray(notes).map(x => ({
-        ...x,
-        se_module,
-        Parent_Id
-      }))
-    };
-    return createNotesInstance(createNotesRequest);
-  };
+function getEmailsForRecordPageFactory(context) {
+  return zohoFetchPageFactory(getEmailsForRecord(context));
 }
 class ZohoRecruitExecuteRestApiFunctionError extends BaseError {
   constructor(error) {
@@ -2594,19 +2584,6 @@ function zohoRecruitMultiRecordResult(input, results) {
   return result;
 }
 
-/**
- * Candidates module name
- */
-const ZOHO_RECRUIT_CANDIDATES_MODULE = 'Candidates';
-/**
- * Job Openings module name
- */
-const ZOHO_RECRUIT_JOB_OPENINGS_MODULE = 'Job_Openings';
-/**
- * Returns true if it is a valid ZohoRecruitValidUrl.
- */
-const isZohoRecruitValidUrl = isStandardInternetAccessibleWebsiteUrl;
-
 /**
  * Associates one or more candidates with one or more job openings.
  *
@@ -2668,6 +2645,109 @@ function searchJobOpeningAssociatedCandidateRecordsPageFactory(context) {
   return zohoFetchPageFactory(searchJobOpeningAssociatedCandidateRecords(context));
 }
 
+function createNotes(context) {
+  return input => context.fetchJson(`/v2/${ZOHO_RECRUIT_NOTES_MODULE}`, zohoRecruitApiFetchJsonInput('POST', {
+    data: input.data
+  })).then(x => {
+    return zohoRecruitMultiRecordResult(asArray(input.data), x.data);
+  });
+}
+function deleteNotes(context) {
+  return input => context.fetchJson(`/v2/${ZOHO_RECRUIT_NOTES_MODULE}?${makeUrlSearchParams({
+    ids: input.ids
+  })}`, zohoRecruitApiFetchJsonInput('DELETE')).then(x => {
+    return zohoRecruitMultiRecordResult(asArray(input.ids), x.data);
+  });
+}
+function getNotesForRecord(context) {
+  return getRelatedRecordsFunctionFactory(context)({
+    targetModule: ZOHO_RECRUIT_NOTES_MODULE
+  });
+}
+function getNotesForRecordPageFactory(context) {
+  return zohoFetchPageFactory(getNotesForRecord(context));
+}
+function createNotesForRecord(context) {
+  const createNotesInstance = createNotes(context);
+  return input => {
+    const {
+      module: se_module,
+      id: Parent_Id,
+      notes
+    } = input;
+    const createNotesRequest = {
+      data: asArray(notes).map(x => ({
+        ...x,
+        se_module,
+        Parent_Id
+      }))
+    };
+    return createNotesInstance(createNotesRequest);
+  };
+}
+
+function createTagsForModule(context) {
+  return input => context.fetchJson(`/v2/settings/tags?${makeUrlSearchParams({
+    module: input.module
+  })}`, zohoRecruitApiFetchJsonInput('POST', {
+    tags: asArray(input.tags)
+  })).then(x => {
+    const result = zohoRecruitMultiRecordResult(asArray(input.tags), x.tags);
+    const {
+      included: duplicateErrorItems,
+      excluded: otherErrorItems
+    } = separateValues(result.errorItems, x => {
+      return x.result.code === ZOHO_DUPLICATE_DATA_ERROR_CODE;
+    });
+    return {
+      ...result,
+      errorItems: otherErrorItems,
+      duplicateErrorItems,
+      allErrorItems: result.errorItems
+    };
+  });
+}
+/**
+ * Returns the list of tags within a module.
+ *
+ * https://www.zoho.com/recruit/developer-guide/apiv2/get-tag-list.html
+ *
+ * @param context
+ * @returns
+ */
+function getTagsForModule(context) {
+  return input => context.fetchJson(`/v2/settings/tags?${makeUrlSearchParams({
+    module: input.module,
+    my_tags: input.my_tags
+  })}`, zohoRecruitApiFetchJsonInput('GET')).then(x => {
+    // NOTE: This doesn't follow the api documentation, and instead is a normal page result except it has "tags" instead of "data".
+    return {
+      ...x,
+      data: x.tags
+    };
+  });
+}
+function getTagsForModulePageFactory(context) {
+  return zohoFetchPageFactory(getTagsForModule(context));
+}
+/**
+ * Associates one or more candidates with one or more job openings.
+ *
+ * https://www.zoho.com/recruit/developer-guide/apiv2/associate-candidate.html
+ *
+ * @param context
+ * @returns
+ */
+function addTagsToRecords(context) {
+  return input => context.fetchJson(`/v2/${ZOHO_RECRUIT_CANDIDATES_MODULE}/actions/add_tags?${makeUrlSearchParams({
+    tag_names: input.tag_names,
+    ids: input.ids
+  })}`, zohoRecruitApiFetchJsonInput('POST')).then(x => {
+    const resultInputMap = x.data.map(() => input); // assign "input" to each value for now
+    return zohoRecruitMultiRecordResult(resultInputMap, x.data);
+  });
+}
+
 /**
  * Creates a ZohoRecruitSearchRecordsCriteriaEntryArray from an array of emails.
  *
@@ -2866,6 +2946,11 @@ function zohoRecruitFactory(factoryConfig) {
   };
 }
 
+/**
+ * Maximum length of ZohoRecruitTagName
+ */
+const ZOHO_RECRUIT_TAG_NAME_MAX_LENGTH = 25;
+
 /**
  * Trades a refresh token for a new AccessToken
  * @param context
@@ -3034,4 +3119,4 @@ function zohoDateTimeString(date) {
   return isoDate.substring(0, isoDate.length - 5) + 'Z';
 }
 
-export { DEFAULT_ZOHO_API_RATE_LIMIT, DEFAULT_ZOHO_API_RATE_LIMIT_RESET_PERIOD, DEFAULT_ZOHO_RATE_LIMITED_TOO_MANY_REQUETS_LOG_FUNCTION, MAX_ZOHO_RECRUIT_SEARCH_MODULE_RECORDS_CRITERIA, ZOHO_ACCOUNTS_INVALID_CLIENT_ERROR_CODE, ZOHO_ACCOUNTS_INVALID_CODE_ERROR_CODE, ZOHO_ACCOUNTS_US_API_URL, ZOHO_DUPLICATE_DATA_ERROR_CODE, ZOHO_ERROR_STATUS, ZOHO_FAILURE_ERROR_CODE, ZOHO_INTERNAL_ERROR_CODE, ZOHO_INVALID_AUTHORIZATION_ERROR_CODE, ZOHO_INVALID_DATA_ERROR_CODE, ZOHO_INVALID_QUERY_ERROR_CODE, ZOHO_MANDATORY_NOT_FOUND_ERROR_CODE, ZOHO_RATE_LIMIT_LIMIT_HEADER, ZOHO_RATE_LIMIT_REMAINING_HEADER, ZOHO_RATE_LIMIT_RESET_HEADER, ZOHO_RECRUIT_ALREADY_ASSOCIATED_ERROR_CODE, ZOHO_RECRUIT_CANDIDATES_MODULE, ZOHO_RECRUIT_JOB_OPENINGS_MODULE, ZOHO_RECRUIT_SERVICE_NAME, ZOHO_SUCCESS_CODE, ZOHO_SUCCESS_STATUS, ZOHO_TOO_MANY_REQUESTS_ERROR_CODE, ZOHO_TOO_MANY_REQUESTS_HTTP_STATUS_CODE, ZohoAccountsAccessTokenError, ZohoAccountsAuthFailureError, ZohoInternalError, ZohoInvalidAuthorizationError, ZohoInvalidQueryError, ZohoRecruitExecuteRestApiFunctionError, ZohoRecruitRecordCrudDuplicateDataError, ZohoRecruitRecordCrudError, ZohoRecruitRecordCrudInvalidDataError, ZohoRecruitRecordCrudMandatoryFieldNotFoundError, ZohoRecruitRecordCrudNoMatchingRecordError, ZohoRecruitRecordNoContentError, ZohoServerError, ZohoServerFetchResponseError, ZohoTooManyRequestsError, accessToken, assertRecordDataArrayResultHasContent, associateCandidateRecordsWithJobOpenings, createNotes, createNotesForRecord, deleteNotes, deleteRecord, emptyZohoPageResult, escapeZohoFieldValueForCriteriaString, executeRestApiFunction, getNotesForRecord, getNotesForRecordPageFactory, getRecordById, getRecords, getRelatedRecordsFunctionFactory, handleZohoAccountsErrorFetch, handleZohoErrorFetchFactory, handleZohoRecruitErrorFetch, insertRecord, interceptZohoAccounts200StatusWithErrorResponse, interceptZohoErrorResponseFactory, interceptZohoRecruit200StatusWithErrorResponse, isZohoRecruitValidUrl, logZohoAccountsErrorToConsole, logZohoRecruitErrorToConsole, logZohoServerErrorFunction, parseZohoAccountsError, parseZohoAccountsServerErrorResponseData, parseZohoRecruitError, parseZohoRecruitServerErrorResponseData, parseZohoServerErrorResponseData, safeZohoDateTimeString, searchAssociatedRecords, searchCandidateAssociatedJobOpeningRecords, searchCandidateAssociatedJobOpeningRecordsPageFactory, searchJobOpeningAssociatedCandidateRecords, searchJobOpeningAssociatedCandidateRecordsPageFactory, searchRecords, searchRecordsPageFactory, tryFindZohoServerErrorData, updateRecord, upsertRecord, zohoAccessTokenStringFactory, zohoAccountsApiFetchJsonInput, zohoAccountsConfigApiUrl, zohoAccountsFactory, zohoAccountsZohoAccessTokenFactory, zohoDateTimeString, zohoFetchPageFactory, zohoRateLimitHeaderDetails, zohoRateLimitedFetchHandler, zohoRecruitApiFetchJsonInput, zohoRecruitChangeObjectLikeResponseSuccessAndErrorPairs, zohoRecruitConfigApiUrl, zohoRecruitFactory, zohoRecruitMultiRecordResult, zohoRecruitRecordCrudError, zohoRecruitSearchRecordsCriteriaEntriesForEmails, zohoRecruitSearchRecordsCriteriaEntryToCriteriaString, zohoRecruitSearchRecordsCriteriaString, zohoRecruitSearchRecordsCriteriaStringForTree, zohoRecruitUrlSearchParams, zohoRecruitUrlSearchParamsMinusIdAndModule, zohoRecruitUrlSearchParamsMinusModule, zohoServerErrorData };
+export { DEFAULT_ZOHO_API_RATE_LIMIT, DEFAULT_ZOHO_API_RATE_LIMIT_RESET_PERIOD, DEFAULT_ZOHO_RATE_LIMITED_TOO_MANY_REQUETS_LOG_FUNCTION, MAX_ZOHO_RECRUIT_SEARCH_MODULE_RECORDS_CRITERIA, ZOHO_ACCOUNTS_INVALID_CLIENT_ERROR_CODE, ZOHO_ACCOUNTS_INVALID_CODE_ERROR_CODE, ZOHO_ACCOUNTS_US_API_URL, ZOHO_DUPLICATE_DATA_ERROR_CODE, ZOHO_ERROR_STATUS, ZOHO_FAILURE_ERROR_CODE, ZOHO_INTERNAL_ERROR_CODE, ZOHO_INVALID_AUTHORIZATION_ERROR_CODE, ZOHO_INVALID_DATA_ERROR_CODE, ZOHO_INVALID_QUERY_ERROR_CODE, ZOHO_MANDATORY_NOT_FOUND_ERROR_CODE, ZOHO_RATE_LIMIT_LIMIT_HEADER, ZOHO_RATE_LIMIT_REMAINING_HEADER, ZOHO_RATE_LIMIT_RESET_HEADER, ZOHO_RECRUIT_ALREADY_ASSOCIATED_ERROR_CODE, ZOHO_RECRUIT_CANDIDATES_MODULE, ZOHO_RECRUIT_EMAILS_MODULE, ZOHO_RECRUIT_JOB_OPENINGS_MODULE, ZOHO_RECRUIT_NOTES_MODULE, ZOHO_RECRUIT_SERVICE_NAME, ZOHO_RECRUIT_TAG_NAME_MAX_LENGTH, ZOHO_SUCCESS_CODE, ZOHO_SUCCESS_STATUS, ZOHO_TOO_MANY_REQUESTS_ERROR_CODE, ZOHO_TOO_MANY_REQUESTS_HTTP_STATUS_CODE, ZohoAccountsAccessTokenError, ZohoAccountsAuthFailureError, ZohoInternalError, ZohoInvalidAuthorizationError, ZohoInvalidQueryError, ZohoRecruitExecuteRestApiFunctionError, ZohoRecruitRecordCrudDuplicateDataError, ZohoRecruitRecordCrudError, ZohoRecruitRecordCrudInvalidDataError, ZohoRecruitRecordCrudMandatoryFieldNotFoundError, ZohoRecruitRecordCrudNoMatchingRecordError, ZohoRecruitRecordNoContentError, ZohoServerError, ZohoServerFetchResponseError, ZohoTooManyRequestsError, accessToken, addTagsToRecords, assertRecordDataArrayResultHasContent, associateCandidateRecordsWithJobOpenings, createNotes, createNotesForRecord, createTagsForModule, deleteNotes, deleteRecord, emptyZohoPageResult, escapeZohoFieldValueForCriteriaString, executeRestApiFunction, getEmailsForRecord, getEmailsForRecordPageFactory, getNotesForRecord, getNotesForRecordPageFactory, getRecordById, getRecords, getRelatedRecordsFunctionFactory, getTagsForModule, getTagsForModulePageFactory, handleZohoAccountsErrorFetch, handleZohoErrorFetchFactory, handleZohoRecruitErrorFetch, insertRecord, interceptZohoAccounts200StatusWithErrorResponse, interceptZohoErrorResponseFactory, interceptZohoRecruit200StatusWithErrorResponse, isZohoRecruitValidUrl, logZohoAccountsErrorToConsole, logZohoRecruitErrorToConsole, logZohoServerErrorFunction, parseZohoAccountsError, parseZohoAccountsServerErrorResponseData, parseZohoRecruitError, parseZohoRecruitServerErrorResponseData, parseZohoServerErrorResponseData, safeZohoDateTimeString, searchAssociatedRecords, searchCandidateAssociatedJobOpeningRecords, searchCandidateAssociatedJobOpeningRecordsPageFactory, searchJobOpeningAssociatedCandidateRecords, searchJobOpeningAssociatedCandidateRecordsPageFactory, searchRecords, searchRecordsPageFactory, tryFindZohoServerErrorData, updateRecord, upsertRecord, zohoAccessTokenStringFactory, zohoAccountsApiFetchJsonInput, zohoAccountsConfigApiUrl, zohoAccountsFactory, zohoAccountsZohoAccessTokenFactory, zohoDateTimeString, zohoFetchPageFactory, zohoRateLimitHeaderDetails, zohoRateLimitedFetchHandler, zohoRecruitApiFetchJsonInput, zohoRecruitChangeObjectLikeResponseSuccessAndErrorPairs, zohoRecruitConfigApiUrl, zohoRecruitFactory, zohoRecruitMultiRecordResult, zohoRecruitRecordCrudError, zohoRecruitSearchRecordsCriteriaEntriesForEmails, zohoRecruitSearchRecordsCriteriaEntryToCriteriaString, zohoRecruitSearchRecordsCriteriaString, zohoRecruitSearchRecordsCriteriaStringForTree, zohoRecruitUrlSearchParams, zohoRecruitUrlSearchParamsMinusIdAndModule, zohoRecruitUrlSearchParamsMinusModule, zohoServerErrorData };

package/nestjs/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [12.1.13](https://github.com/dereekb/dbx-components/compare/v12.1.12-dev...v12.1.13) (2025-06-23)
+
+
+
 ## [12.1.12](https://github.com/dereekb/dbx-components/compare/v12.1.11...v12.1.12) (2025-06-19)
 
 

package/nestjs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/zoho/nestjs",
-  "version": "12.1.12",
+  "version": "12.1.13",
   "type": "commonjs",
   "types": "./src/index.d.ts",
   "main": "./src/index.js"

package/nestjs/src/lib/recruit/recruit.api.d.ts

@@ -16,6 +16,9 @@ export declare class ZohoRecruitApi {
     get getRecords(): import("@dereekb/zoho").ZohoRecruitGetRecordsFunction;
     get searchRecords(): import("@dereekb/zoho").ZohoRecruitSearchRecordsFunction;
     get searchRecordsPageFactory(): import("@dereekb/zoho").SearchRecordsPageFactory;
+    get getRelatedRecordsFunctionFactory(): import("@dereekb/zoho").ZohoRecruitGetRelatedRecordsFunctionFactory;
+    get getEmailsForRecord(): import("@dereekb/zoho").ZohoRecruitGetEmailsForRecordFunction;
+    get getEmailsForRecordPageFactory(): import("@dereekb/zoho").GetEmailsForRecordPageFactory;
     get createNotes(): (input: import("@dereekb/zoho").ZohoRecruitCreateNotesRequest) => Promise<import("@dereekb/zoho").ZohoRecruitMultiRecordResult<import("@dereekb/zoho").NewZohoRecruitNoteData, import("@dereekb/zoho").ZohoRecruitChangeObjectResponseSuccessEntry<import("@dereekb/zoho").ZohoRecruitChangeObjectDetails>, import("@dereekb/zoho").ZohoRecruitChangeObjectResponseErrorEntry>>;
     get deleteNotes(): (input: import("@dereekb/zoho").ZohoRecruitDeleteNotesRequest) => Promise<import("@dereekb/zoho").ZohoRecruitMultiRecordResult<string, import("@dereekb/zoho").ZohoRecruitChangeObjectResponseSuccessEntry<import("@dereekb/zoho").ZohoRecruitChangeObjectDetails>, import("@dereekb/zoho").ZohoRecruitChangeObjectResponseErrorEntry>>;
     get createNotesForRecord(): import("@dereekb/zoho").ZohoRecruitCreateNotesForRecordFunction;
@@ -27,4 +30,12 @@ export declare class ZohoRecruitApi {
     get searchCandidateAssociatedJobOpeningRecordsPageFactory(): import("dist/packages/util/fetch/src").FetchPageFactory<import("@dereekb/zoho").ZohoRecruitSearchCandidateAssociatedJobOpeningRecordsInput, import("@dereekb/zoho").ZohoRecruitSearchAssociatedRecordsResponse<import("@dereekb/zoho").ZohoRecruitRecord>>;
     get searchJobOpeningAssociatedCandidateRecords(): import("@dereekb/zoho").ZohoRecruitSearchJobOpeningAssociatedCandidateRecordsFunction<import("@dereekb/zoho").ZohoRecruitRecord>;
     get searchJobOpeningAssociatedCandidateRecordsPageFactory(): import("dist/packages/util/fetch/src").FetchPageFactory<import("@dereekb/zoho").ZohoRecruitSearchJobOpeningAssociatedCandidateRecordsInput, import("@dereekb/zoho").ZohoRecruitSearchAssociatedRecordsResponse<import("@dereekb/zoho").ZohoRecruitRecord>>;
+    get createTagsForModule(): (input: import("@dereekb/zoho").ZohoRecruitCreateTagsRequest) => Promise<{
+        errorItems: import("@dereekb/zoho").ZohoRecruitMultiRecordResultEntry<import("@dereekb/zoho").ZohoRecruitCreateTagData, import("@dereekb/zoho").ZohoRecruitChangeObjectResponseErrorEntry>[];
+        duplicateErrorItems: import("@dereekb/zoho").ZohoRecruitMultiRecordResultEntry<import("@dereekb/zoho").ZohoRecruitCreateTagData, import("@dereekb/zoho").ZohoRecruitChangeObjectResponseErrorEntry>[];
+        allErrorItems: import("@dereekb/zoho").ZohoRecruitMultiRecordResultEntry<import("@dereekb/zoho").ZohoRecruitCreateTagData, import("@dereekb/zoho").ZohoRecruitChangeObjectResponseErrorEntry>[];
+        successItems: import("@dereekb/zoho").ZohoRecruitMultiRecordResultEntry<import("@dereekb/zoho").ZohoRecruitCreateTagData, import("@dereekb/zoho").ZohoRecruitChangeObjectResponseSuccessEntry<import("@dereekb/zoho").ZohoRecruitChangeObjectDetails>>[];
+    }>;
+    get getTagsForModule(): import("@dereekb/zoho").ZohoRecruitGetTagsFunction;
+    get addTagsToRecords(): import("@dereekb/zoho").ZohoRecruitAddTagsToRecordsFunction;
 }

package/nestjs/src/lib/recruit/recruit.api.js

@@ -49,6 +49,15 @@ let ZohoRecruitApi = class ZohoRecruitApi {
     get searchRecordsPageFactory() {
         return (0, zoho_1.searchRecordsPageFactory)(this.recruitContext);
     }
+    get getRelatedRecordsFunctionFactory() {
+        return (0, zoho_1.getRelatedRecordsFunctionFactory)(this.recruitContext);
+    }
+    get getEmailsForRecord() {
+        return (0, zoho_1.getEmailsForRecord)(this.recruitContext);
+    }
+    get getEmailsForRecordPageFactory() {
+        return (0, zoho_1.getEmailsForRecordPageFactory)(this.recruitContext);
+    }
     get createNotes() {
         return (0, zoho_1.createNotes)(this.recruitContext);
     }
@@ -82,6 +91,15 @@ let ZohoRecruitApi = class ZohoRecruitApi {
     get searchJobOpeningAssociatedCandidateRecordsPageFactory() {
         return (0, zoho_1.searchJobOpeningAssociatedCandidateRecordsPageFactory)(this.recruitContext);
     }
+    get createTagsForModule() {
+        return (0, zoho_1.createTagsForModule)(this.recruitContext);
+    }
+    get getTagsForModule() {
+        return (0, zoho_1.getTagsForModule)(this.recruitContext);
+    }
+    get addTagsToRecords() {
+        return (0, zoho_1.addTagsToRecords)(this.recruitContext);
+    }
 };
 exports.ZohoRecruitApi = ZohoRecruitApi;
 exports.ZohoRecruitApi = ZohoRecruitApi = tslib_1.__decorate([

package/nestjs/src/lib/recruit/recruit.api.js.map

@@ -1 +1 @@
-{"version":3,"file":"recruit.api.js","sourceRoot":"","sources":["../../../../../../../packages/zoho/nestjs/src/lib/recruit/recruit.api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"recruit.api.js","sourceRoot":"","sources":["../../../../../../../packages/zoho/nestjs/src/lib/recruit/recruit.api.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/zoho",
-  "version": "12.1.12",
+  "version": "12.1.13",
   "exports": {
     ".": {
       "types": "./src/index.d.ts",

package/src/lib/recruit/index.d.ts

@@ -1,8 +1,12 @@
 export * from './recruit.api';
 export * from './recruit.api.candidates';
+export * from './recruit.api.notes';
+export * from './recruit.api.tags';
 export * from './recruit.config';
 export * from './recruit.criteria';
 export * from './recruit.criteria.util';
 export * from './recruit.error.api';
 export * from './recruit.factory';
 export * from './recruit';
+export * from './recruit.tags';
+export * from './recruit.notes';

package/src/lib/recruit/recruit.api.d.ts

@@ -1,7 +1,7 @@
 import { ZohoDataArrayResultRef, ZohoPageFilter, ZohoPageResult } from './../zoho.api.page';
 import { FetchJsonBody, FetchJsonInput, FetchPage, FetchPageFactory, FetchPageFactoryOptions, makeUrlSearchParams } from '@dereekb/util/fetch';
 import { ZohoRecruitConfigApiUrlInput, ZohoRecruitContext } from './recruit.config';
-import { NewZohoRecruitNoteData, ZohoRecruitCommaSeparateFieldNames, ZohoRecruitCustomViewId, ZohoRecruitDraftOrSaveState, ZohoRecruitFieldName, ZohoRecruitModuleNameRef, ZohoRecruitChangeObjectDetails, ZohoRecruitRecord, ZohoRecruitRecordId, ZohoRecruitRecordNote, ZohoRecruitTerritoryId, ZohoRecruitTrueFalseBoth, ZohoRecruitNoteId, ZohoRecruitRestFunctionApiName, ZohoRecruitUserId, ZohoRecruitModuleName } from './recruit';
+import { ZohoRecruitCommaSeparateFieldNames, ZohoRecruitCustomViewId, ZohoRecruitDraftOrSaveState, ZohoRecruitFieldName, ZohoRecruitModuleNameRef, ZohoRecruitChangeObjectDetails, ZohoRecruitRecord, ZohoRecruitRecordId, ZohoRecruitTerritoryId, ZohoRecruitTrueFalseBoth, ZohoRecruitRestFunctionApiName, ZohoRecruitUserId, ZohoRecruitModuleName, ZohoRecruitRecordEmailMetadata } from './recruit';
 import { ZohoRecruitSearchRecordsCriteriaTreeElement } from './recruit.criteria';
 import { ArrayOrValue, EmailAddress, Maybe, PhoneNumber, SortingOrder, UniqueModelWithId } from '@dereekb/util';
 import { ZohoServerErrorDataWithDetails, ZohoServerErrorStatus, ZohoServerSuccessCode, ZohoServerSuccessStatus } from '../zoho.error.api';
@@ -165,8 +165,14 @@ export type SearchRecordsPageFactory = <T = ZohoRecruitRecord>(input: ZohoRecrui
 export declare function searchRecordsPageFactory(context: ZohoRecruitContext): SearchRecordsPageFactory;
 export interface ZohoRecruitGetRelatedRecordsFunctionConfig {
     readonly targetModule: ZohoRecruitModuleName;
+    /**
+     * If true, will return an empty page result instead of null when no results are found.
+     *
+     * Defaults to true.
+     */
+    readonly returnEmptyRecordsInsteadOfNull?: boolean;
 }
-export type ZohoRecruitGetRelatedRecordsFunctionFactory = <T extends ZohoRecruitRecord>(input: ZohoRecruitGetRelatedRecordsFunctionConfig) => ZohoRecruitGetRelatedRecordsFunction<T>;
+export type ZohoRecruitGetRelatedRecordsFunctionFactory = <T = ZohoRecruitRecord>(input: ZohoRecruitGetRelatedRecordsFunctionConfig) => ZohoRecruitGetRelatedRecordsFunction<T>;
 export type ZohoRecruitGetRelatedRecordsPageFilter = ZohoPageFilter;
 export interface ZohoRecruitGetRelatedRecordsRequest extends ZohoRecruitGetRecordByIdInput, ZohoRecruitGetRelatedRecordsPageFilter {
     /**
@@ -191,33 +197,12 @@ export type ZohoRecruitGetRelatedRecordsFunction<T = ZohoRecruitRecord> = (input
  * @returns a ZohoRecruitGetRelatedRecordsFunctionFactory
  */
 export declare function getRelatedRecordsFunctionFactory(context: ZohoRecruitContext): ZohoRecruitGetRelatedRecordsFunctionFactory;
-export interface ZohoRecruitCreateNotesRequest {
-    readonly data: ZohoRecruitCreateNotesRequestEntry[];
-}
-export type ZohoRecruitCreateNotesResult = ZohoRecruitMultiRecordResult<ZohoRecruitCreateNotesRequestEntry, ZohoRecruitChangeObjectResponseSuccessEntry, ZohoRecruitChangeObjectResponseErrorEntry>;
-export type ZohoRecruitCreateNotesRequestEntry = NewZohoRecruitNoteData;
-export type ZohoRecruitCreateNotesResponse = ZohoRecruitChangeObjectResponse;
-export type ZohoRecruitCreateNotesFunction = (input: ZohoRecruitCreateNotesRequest) => Promise<ZohoRecruitCreateNotesResult>;
-export declare function createNotes(context: ZohoRecruitContext): (input: ZohoRecruitCreateNotesRequest) => Promise<ZohoRecruitMultiRecordResult<NewZohoRecruitNoteData, ZohoRecruitChangeObjectResponseSuccessEntry<ZohoRecruitChangeObjectDetails>, ZohoRecruitChangeObjectResponseErrorEntry>>;
-export interface ZohoRecruitDeleteNotesRequest {
-    readonly ids: ArrayOrValue<ZohoRecruitNoteId>;
-}
-export type ZohoRecruitDeleteNotesResult = ZohoRecruitMultiRecordResult<ZohoRecruitNoteId, ZohoRecruitChangeObjectResponseSuccessEntry, ZohoRecruitChangeObjectResponseErrorEntry>;
-export type ZohoRecruitDeleteNotesResponse = ZohoRecruitChangeObjectResponse;
-export type ZohoRecruitDeleteNotesFunction = (input: ZohoRecruitDeleteNotesRequest) => Promise<ZohoRecruitDeleteNotesResult>;
-export declare function deleteNotes(context: ZohoRecruitContext): (input: ZohoRecruitDeleteNotesRequest) => Promise<ZohoRecruitMultiRecordResult<string, ZohoRecruitChangeObjectResponseSuccessEntry<ZohoRecruitChangeObjectDetails>, ZohoRecruitChangeObjectResponseErrorEntry>>;
-export type ZohoRecruitGetNotesForRecordRequest = ZohoRecruitGetRelatedRecordsRequest;
-export type ZohoRecruitGetNotesForRecordResponse = ZohoPageResult<ZohoRecruitRecordNote>;
-export type ZohoRecruitGetNotesForRecordFunction = (input: ZohoRecruitGetNotesForRecordRequest) => Promise<ZohoRecruitGetNotesForRecordResponse>;
-export declare function getNotesForRecord(context: ZohoRecruitContext): ZohoRecruitGetNotesForRecordFunction;
-export type GetNotesForRecordPageFactory = FetchPageFactory<ZohoRecruitGetNotesForRecordRequest, ZohoRecruitGetNotesForRecordResponse>;
-export declare function getNotesForRecordPageFactory(context: ZohoRecruitContext): GetNotesForRecordPageFactory;
-export interface ZohoRecruitCreateNotesForRecordRequest extends ZohoRecruitModuleNameRef {
-    readonly id: ZohoRecruitRecordId;
-    readonly notes: ArrayOrValue<Omit<NewZohoRecruitNoteData, 'se_module' | 'Parent_Id'>>;
-}
-export type ZohoRecruitCreateNotesForRecordFunction = (input: ZohoRecruitCreateNotesForRecordRequest) => Promise<ZohoRecruitCreateNotesResult>;
-export declare function createNotesForRecord(context: ZohoRecruitContext): ZohoRecruitCreateNotesForRecordFunction;
+export type ZohoRecruitGetEmailsForRecordRequest = ZohoRecruitGetRelatedRecordsRequest;
+export type ZohoRecruitGetEmailsForRecordResponse = ZohoPageResult<ZohoRecruitRecordEmailMetadata>;
+export type ZohoRecruitGetEmailsForRecordFunction = (input: ZohoRecruitGetEmailsForRecordRequest) => Promise<ZohoRecruitGetEmailsForRecordResponse>;
+export declare function getEmailsForRecord(context: ZohoRecruitContext): ZohoRecruitGetEmailsForRecordFunction;
+export type GetEmailsForRecordPageFactory = FetchPageFactory<ZohoRecruitGetEmailsForRecordRequest, ZohoRecruitGetEmailsForRecordResponse>;
+export declare function getEmailsForRecordPageFactory(context: ZohoRecruitContext): GetEmailsForRecordPageFactory;
 export type ZohoRecruitExecuteRestApiFunctionRequest = ZohoRecruitExecuteRestApiFunctionNormalRequest | ZohoRecruitExecuteRestApiFunctionApiSpecificRequest;
 export interface ZohoRecruitExecuteRestApiFunctionNormalRequest {
     readonly functionName: ZohoRecruitRestFunctionApiName;

package/src/lib/recruit/recruit.api.notes.d.ts

@@ -0,0 +1,34 @@
+import { ZohoPageResult } from '../zoho.api.page';
+import { FetchPageFactory } from '@dereekb/util/fetch';
+import { ZohoRecruitContext } from './recruit.config';
+import { ZohoRecruitModuleNameRef, ZohoRecruitRecordId } from './recruit';
+import { ArrayOrValue } from '@dereekb/util';
+import { ZohoRecruitMultiRecordResult, ZohoRecruitChangeObjectResponseSuccessEntry, ZohoRecruitChangeObjectResponseErrorEntry, ZohoRecruitChangeObjectResponse, ZohoRecruitGetRelatedRecordsRequest } from './recruit.api';
+import { NewZohoRecruitNoteData, ZohoRecruitNoteId, ZohoRecruitRecordNote } from './recruit.notes';
+export interface ZohoRecruitCreateNotesRequest {
+    readonly data: ZohoRecruitCreateNotesRequestEntry[];
+}
+export type ZohoRecruitCreateNotesResult = ZohoRecruitMultiRecordResult<ZohoRecruitCreateNotesRequestEntry, ZohoRecruitChangeObjectResponseSuccessEntry, ZohoRecruitChangeObjectResponseErrorEntry>;
+export type ZohoRecruitCreateNotesRequestEntry = NewZohoRecruitNoteData;
+export type ZohoRecruitCreateNotesResponse = ZohoRecruitChangeObjectResponse;
+export type ZohoRecruitCreateNotesFunction = (input: ZohoRecruitCreateNotesRequest) => Promise<ZohoRecruitCreateNotesResult>;
+export declare function createNotes(context: ZohoRecruitContext): (input: ZohoRecruitCreateNotesRequest) => Promise<ZohoRecruitMultiRecordResult<NewZohoRecruitNoteData, ZohoRecruitChangeObjectResponseSuccessEntry<import("./recruit").ZohoRecruitChangeObjectDetails>, ZohoRecruitChangeObjectResponseErrorEntry>>;
+export interface ZohoRecruitDeleteNotesRequest {
+    readonly ids: ArrayOrValue<ZohoRecruitNoteId>;
+}
+export type ZohoRecruitDeleteNotesResult = ZohoRecruitMultiRecordResult<ZohoRecruitNoteId, ZohoRecruitChangeObjectResponseSuccessEntry, ZohoRecruitChangeObjectResponseErrorEntry>;
+export type ZohoRecruitDeleteNotesResponse = ZohoRecruitChangeObjectResponse;
+export type ZohoRecruitDeleteNotesFunction = (input: ZohoRecruitDeleteNotesRequest) => Promise<ZohoRecruitDeleteNotesResult>;
+export declare function deleteNotes(context: ZohoRecruitContext): (input: ZohoRecruitDeleteNotesRequest) => Promise<ZohoRecruitMultiRecordResult<string, ZohoRecruitChangeObjectResponseSuccessEntry<import("./recruit").ZohoRecruitChangeObjectDetails>, ZohoRecruitChangeObjectResponseErrorEntry>>;
+export type ZohoRecruitGetNotesForRecordRequest = ZohoRecruitGetRelatedRecordsRequest;
+export type ZohoRecruitGetNotesForRecordResponse = ZohoPageResult<ZohoRecruitRecordNote>;
+export type ZohoRecruitGetNotesForRecordFunction = (input: ZohoRecruitGetNotesForRecordRequest) => Promise<ZohoRecruitGetNotesForRecordResponse>;
+export declare function getNotesForRecord(context: ZohoRecruitContext): ZohoRecruitGetNotesForRecordFunction;
+export type GetNotesForRecordPageFactory = FetchPageFactory<ZohoRecruitGetNotesForRecordRequest, ZohoRecruitGetNotesForRecordResponse>;
+export declare function getNotesForRecordPageFactory(context: ZohoRecruitContext): GetNotesForRecordPageFactory;
+export interface ZohoRecruitCreateNotesForRecordRequest extends ZohoRecruitModuleNameRef {
+    readonly id: ZohoRecruitRecordId;
+    readonly notes: ArrayOrValue<Omit<NewZohoRecruitNoteData, 'se_module' | 'Parent_Id'>>;
+}
+export type ZohoRecruitCreateNotesForRecordFunction = (input: ZohoRecruitCreateNotesForRecordRequest) => Promise<ZohoRecruitCreateNotesResult>;
+export declare function createNotesForRecord(context: ZohoRecruitContext): ZohoRecruitCreateNotesForRecordFunction;

package/src/lib/recruit/recruit.api.tags.d.ts

@@ -0,0 +1,86 @@
+import { ZohoRecruitContext } from './recruit.config';
+import { ArrayOrValue, Maybe } from '@dereekb/util';
+import { ZohoRecruitModuleNameRef, ZohoRecruitRecordId } from './recruit';
+import { ZohoRecruitChangeObjectLikeResponse, ZohoRecruitChangeObjectLikeResponseSuccessEntryMeta, ZohoRecruitChangeObjectResponse, ZohoRecruitChangeObjectResponseErrorEntry, ZohoRecruitChangeObjectResponseSuccessEntry, ZohoRecruitGetRecordsPageFilter, ZohoRecruitMultiRecordResult, ZohoRecruitMultiRecordResultEntry } from './recruit.api';
+import { ZohoRecruitTagData, ZohoRecruitTagName, ZohoRecruitTagWithObjectDetails } from './recruit.tags';
+import { FetchPage, FetchPageFactoryOptions } from '@dereekb/util/fetch';
+import { ZohoPageResult } from '../zoho.api.page';
+export type ZohoRecruitCreateTagData = Pick<ZohoRecruitTagData, 'name'> & Partial<Pick<ZohoRecruitTagData, 'color_code'>>;
+export interface ZohoRecruitCreateTagsRequest extends ZohoRecruitModuleNameRef {
+    readonly tags: ArrayOrValue<ZohoRecruitCreateTagData>;
+}
+export interface ZohoRecruitCreateTagsResponse {
+    readonly tags: ZohoRecruitChangeObjectResponse['data'];
+}
+export type ZohoRecruitCreateTagsResult = ZohoRecruitMultiRecordResult<ZohoRecruitCreateTagData, ZohoRecruitChangeObjectResponseSuccessEntry, ZohoRecruitChangeObjectResponseErrorEntry> & {
+    readonly duplicateErrorItems: ZohoRecruitMultiRecordResultEntry<ZohoRecruitCreateTagData, ZohoRecruitChangeObjectResponseErrorEntry>[];
+    readonly allErrorItems: ZohoRecruitMultiRecordResultEntry<ZohoRecruitCreateTagData, ZohoRecruitChangeObjectResponseErrorEntry>[];
+};
+export type ZohoRecruitCreateTagsFunction = (input: ZohoRecruitCreateTagsRequest) => Promise<ZohoRecruitCreateTagsResult>;
+export declare function createTagsForModule(context: ZohoRecruitContext): (input: ZohoRecruitCreateTagsRequest) => Promise<{
+    errorItems: ZohoRecruitMultiRecordResultEntry<ZohoRecruitCreateTagData, ZohoRecruitChangeObjectResponseErrorEntry>[];
+    duplicateErrorItems: ZohoRecruitMultiRecordResultEntry<ZohoRecruitCreateTagData, ZohoRecruitChangeObjectResponseErrorEntry>[];
+    allErrorItems: ZohoRecruitMultiRecordResultEntry<ZohoRecruitCreateTagData, ZohoRecruitChangeObjectResponseErrorEntry>[];
+    successItems: ZohoRecruitMultiRecordResultEntry<ZohoRecruitCreateTagData, ZohoRecruitChangeObjectResponseSuccessEntry<import("./recruit").ZohoRecruitChangeObjectDetails>>[];
+}>;
+export interface ZohoRecruitGetTagsRequest extends ZohoRecruitModuleNameRef, ZohoRecruitGetRecordsPageFilter {
+    readonly my_tags?: string;
+}
+export interface ZohoRecruitGetTagsResponse extends Omit<ZohoPageResult<ZohoRecruitTagWithObjectDetails>, 'data'> {
+    readonly tags: ZohoRecruitTagWithObjectDetails[];
+}
+export type ZohoRecruitGetTagsResult = ZohoPageResult<ZohoRecruitTagWithObjectDetails>;
+export type ZohoRecruitGetTagsFunction = (input: ZohoRecruitGetTagsRequest) => Promise<ZohoRecruitGetTagsResult>;
+/**
+ * Returns the list of tags within a module.
+ *
+ * https://www.zoho.com/recruit/developer-guide/apiv2/get-tag-list.html
+ *
+ * @param context
+ * @returns
+ */
+export declare function getTagsForModule(context: ZohoRecruitContext): ZohoRecruitGetTagsFunction;
+export type GetTagsForModulePageFactory = (input: ZohoRecruitGetTagsRequest, options?: Maybe<FetchPageFactoryOptions<ZohoRecruitGetTagsRequest, ZohoRecruitGetTagsResult>>) => FetchPage<ZohoRecruitGetTagsRequest, ZohoRecruitGetTagsResult>;
+export declare function getTagsForModulePageFactory(context: ZohoRecruitContext): GetTagsForModulePageFactory;
+export interface ZohoRecruitAddTagsToRecordsRequest extends ZohoRecruitModuleNameRef {
+    /**
+     * Tag names to add to the records.
+     */
+    readonly tag_names: ArrayOrValue<ZohoRecruitTagName>;
+    /**
+     * Ids corresponding to the records in the module to add the tags to.
+     */
+    readonly ids: ArrayOrValue<ZohoRecruitRecordId>;
+}
+export interface ZohoRecruitAddTagsToRecordsResultDetails {
+    /**
+     * Record id that was updated
+     */
+    readonly id: ZohoRecruitRecordId;
+    /**
+     * Tag names that were added to the record
+     */
+    readonly tags: ZohoRecruitTagName[];
+}
+export interface ZohoRecruitAddTagsToRecordsSuccessEntry extends ZohoRecruitChangeObjectLikeResponseSuccessEntryMeta {
+    readonly details: ZohoRecruitAddTagsToRecordsResultDetails;
+}
+export type ZohoRecruitAddTagsToRecordsResponse = ZohoRecruitChangeObjectLikeResponse<ZohoRecruitAddTagsToRecordsSuccessEntry>;
+/**
+ * Contains all the details of the error.
+ */
+export type ZohoRecruitAddTagsToRecordsErrorEntryDetails = ZohoRecruitAddTagsToRecordsResultDetails;
+export type ZohoRecruitAddTagsToRecordsErrorEntry = ZohoRecruitChangeObjectResponseErrorEntry & {
+    readonly details: ZohoRecruitAddTagsToRecordsErrorEntryDetails;
+};
+export type ZohoRecruitAddTagsToRecordsResult = ZohoRecruitMultiRecordResult<ZohoRecruitAddTagsToRecordsRequest, ZohoRecruitAddTagsToRecordsSuccessEntry, ZohoRecruitAddTagsToRecordsErrorEntry>;
+export type ZohoRecruitAddTagsToRecordsFunction = (input: ZohoRecruitAddTagsToRecordsRequest) => Promise<ZohoRecruitAddTagsToRecordsResult>;
+/**
+ * Associates one or more candidates with one or more job openings.
+ *
+ * https://www.zoho.com/recruit/developer-guide/apiv2/associate-candidate.html
+ *
+ * @param context
+ * @returns
+ */
+export declare function addTagsToRecords(context: ZohoRecruitContext): ZohoRecruitAddTagsToRecordsFunction;

package/src/lib/recruit/recruit.d.ts

@@ -1,4 +1,4 @@
-import { CommaSeparatedString, ISO8601DateString, UniqueModelWithId, WebsiteUrl } from '@dereekb/util';
+import { CommaSeparatedString, EmailAddress, ISO8601DateString, UniqueModelWithId, WebsiteUrl } from '@dereekb/util';
 /**
  * Zoho Recruit module name.
  *
@@ -13,6 +13,14 @@ export declare const ZOHO_RECRUIT_CANDIDATES_MODULE = "Candidates";
  * Job Openings module name
  */
 export declare const ZOHO_RECRUIT_JOB_OPENINGS_MODULE = "Job_Openings";
+/**
+ * Notes module name
+ */
+export declare const ZOHO_RECRUIT_NOTES_MODULE = "Notes";
+/**
+ * Emails module name
+ */
+export declare const ZOHO_RECRUIT_EMAILS_MODULE = "Emails";
 /**
  * Contains a reference to a module.
  */
@@ -134,54 +142,6 @@ export type ZohoRecruitRecord = UniqueModelWithId & ZohoRecruitRecordFieldsData;
  * Returns true if it is a valid ZohoRecruitValidUrl.
  */
 export declare const isZohoRecruitValidUrl: (input: WebsiteUrl) => input is ZohoRecruitValidUrl;
-/**
- * Update details returned by the server for an updated record.
- *
- * @deprecated use ZohoRecruitChangeObjectDetails instead.
- */
-export type ZohoRecruitRecordUpdateDetails = ZohoRecruitChangeObjectDetails;
-export type ZohoRecruitNoteId = string;
-export interface ZohoRecruitNoteAction {
-    $is_system_action: boolean;
-}
-export type ZohoRecruitNoteSourceName = 'NORMAL_USER';
-export type ZohoRecruitNoteSourceType = number;
-export interface ZohoRecruitNoteSource {
-    name: ZohoRecruitNoteSourceName;
-    type: ZohoRecruitNoteSourceType;
-}
-export type ZohoRecruitNoteOwnerData = ZohoRecruitReferenceData;
-export interface ZohoRecruitNoteData {
-    Note_Title: string;
-    Note_Content: string;
-    Parent_Id: ZohoRecruitParentReferenceData;
-    Created_Time: ISO8601DateString;
-    Modified_Time: ISO8601DateString;
-    $attachments: null;
-    $is_edit_allowed: boolean;
-    $editable: boolean;
-    $type_id: ZohoRecruitTypeId;
-    $is_delete_allowed: boolean;
-    $note_action: ZohoRecruitNoteAction;
-    $source: ZohoRecruitNoteSource;
-    $se_module: ZohoRecruitModuleName;
-    $is_shared_to_client: boolean;
-    Note_Owner: ZohoRecruitNoteOwnerData;
-    Created_By: ZohoRecruitCreatedByData;
-    Modified_By: ZohoRecruitModifiedByData;
-    $size: ZohoRecruitNoteFileSize | null;
-    $voice_note: boolean;
-    $status: ZohoRecruitNoteStatus;
-}
-export interface NewZohoRecruitNoteData extends Pick<ZohoRecruitNoteData, 'Note_Title' | 'Note_Content'> {
-    Parent_Id: Pick<ZohoRecruitParentReferenceData, 'id'> | ZohoRecruitId;
-    se_module: ZohoRecruitModuleName;
-}
-export type ZohoRecruitNoteStatus = string;
-export type ZohoRecruitNoteFileSize = number;
-export interface ZohoRecruitNote extends ZohoRecruitNoteData, UniqueModelWithId {
-}
-export type ZohoRecruitRecordNote = ZohoRecruitNote;
 /**
  * The posting title of a job opening.
  */
@@ -191,6 +151,41 @@ export type ZohoRecruitJobOpeningPostingTitle = string;
  */
 export type ZohoRecruitCandidateStatus = string;
 /**
- * @deprecated use NewZohoRecruitNewNoteData instead.
+ * Metadata for a record's email.
+ */
+export interface ZohoRecruitRecordEmailMetadata {
+    /**
+     * Whether or not an attachment is present.
+     */
+    attachment: boolean;
+    /**
+     * The subject of the email.
+     */
+    subject: string;
+    /**
+     * The email address the email was sent to.
+     */
+    to: EmailAddress;
+    /**
+     * The email address the email was sent from.
+     */
+    from: EmailAddress;
+    /**
+     * The date the email was sent.
+     */
+    sent_on: ISO8601DateString;
+    /**
+     * The status of the email.
+     */
+    status: ZohoRecruitRecordEmailMetadataStatus[];
+}
+export type ZohoRecruitRecordEmailMetadataStatusType = 'sent' | string;
+export interface ZohoRecruitRecordEmailMetadataStatus {
+    type: ZohoRecruitRecordEmailMetadataStatusType;
+}
+/**
+ * Update details returned by the server for an updated record.
+ *
+ * @deprecated use ZohoRecruitChangeObjectDetails instead.
  */
-export type NewZohoRecruitNewNoteData = NewZohoRecruitNoteData;
+export type ZohoRecruitRecordUpdateDetails = ZohoRecruitChangeObjectDetails;

package/src/lib/recruit/recruit.notes.d.ts

@@ -0,0 +1,48 @@
+import { ISO8601DateString, UniqueModelWithId } from '@dereekb/util';
+import { ZohoRecruitReferenceData, ZohoRecruitParentReferenceData, ZohoRecruitTypeId, ZohoRecruitModuleName, ZohoRecruitCreatedByData, ZohoRecruitModifiedByData, ZohoRecruitId } from './recruit';
+export type ZohoRecruitNoteId = string;
+export interface ZohoRecruitNoteAction {
+    $is_system_action: boolean;
+}
+export type ZohoRecruitNoteSourceName = 'NORMAL_USER';
+export type ZohoRecruitNoteSourceType = number;
+export interface ZohoRecruitNoteSource {
+    name: ZohoRecruitNoteSourceName;
+    type: ZohoRecruitNoteSourceType;
+}
+export type ZohoRecruitNoteOwnerData = ZohoRecruitReferenceData;
+export interface ZohoRecruitNoteData {
+    Note_Title: string;
+    Note_Content: string;
+    Parent_Id: ZohoRecruitParentReferenceData;
+    Created_Time: ISO8601DateString;
+    Modified_Time: ISO8601DateString;
+    $attachments: null;
+    $is_edit_allowed: boolean;
+    $editable: boolean;
+    $type_id: ZohoRecruitTypeId;
+    $is_delete_allowed: boolean;
+    $note_action: ZohoRecruitNoteAction;
+    $source: ZohoRecruitNoteSource;
+    $se_module: ZohoRecruitModuleName;
+    $is_shared_to_client: boolean;
+    Note_Owner: ZohoRecruitNoteOwnerData;
+    Created_By: ZohoRecruitCreatedByData;
+    Modified_By: ZohoRecruitModifiedByData;
+    $size: ZohoRecruitNoteFileSize | null;
+    $voice_note: boolean;
+    $status: ZohoRecruitNoteStatus;
+}
+export interface NewZohoRecruitNoteData extends Pick<ZohoRecruitNoteData, 'Note_Title' | 'Note_Content'> {
+    Parent_Id: Pick<ZohoRecruitParentReferenceData, 'id'> | ZohoRecruitId;
+    se_module: ZohoRecruitModuleName;
+}
+export type ZohoRecruitNoteStatus = string;
+export type ZohoRecruitNoteFileSize = number;
+export interface ZohoRecruitNote extends ZohoRecruitNoteData, UniqueModelWithId {
+}
+export type ZohoRecruitRecordNote = ZohoRecruitNote;
+/**
+ * @deprecated use NewZohoRecruitNewNoteData instead.
+ */
+export type NewZohoRecruitNewNoteData = NewZohoRecruitNoteData;

package/src/lib/recruit/recruit.tags.d.ts

@@ -0,0 +1,34 @@
+import { HexColorCode } from '@dereekb/util';
+import { ZohoRecruitChangeObjectDetails } from './recruit';
+export type ZohoRecruitTagId = string;
+/**
+ * Name of a tag.
+ *
+ * Max length of 25 characters.
+ */
+export type ZohoRecruitTagName = string;
+/**
+ * Maximum length of ZohoRecruitTagName
+ */
+export declare const ZOHO_RECRUIT_TAG_NAME_MAX_LENGTH = 25;
+/**
+ * Hex color code of a tag
+ */
+export type ZohoRecruitTagColorCode = HexColorCode;
+/**
+ * The color and name of a Tag in Zoho Recruit.
+ */
+export interface ZohoRecruitTagData {
+    color_code: ZohoRecruitTagColorCode;
+    name: ZohoRecruitTagName;
+}
+/**
+ * Includes the id of the Tag along with other tag data.
+ */
+export interface ZohoRecruitTag extends ZohoRecruitTagData {
+    id: ZohoRecruitTagId;
+}
+/**
+ * ZohoRecruitTag that also has ZohoRecruitChangeObjectDetails
+ */
+export type ZohoRecruitTagWithObjectDetails = ZohoRecruitTag & ZohoRecruitChangeObjectDetails;