@dereekb/zoho 12.3.6 → 12.3.8

package/index.cjs.js

@@ -1810,10 +1810,15 @@ const ZOHO_RECRUIT_NOTES_MODULE = 'Notes';
  * Emails module name
  */
 const ZOHO_RECRUIT_EMAILS_MODULE = 'Emails';
+/**
+ * Attachments module name
+ */
+const ZOHO_RECRUIT_ATTACHMENTS_MODULE = 'Attachments';
 /**
  * Returns true if it is a valid ZohoRecruitValidUrl.
  */
 const isZohoRecruitValidUrl = util.isStandardInternetAccessibleWebsiteUrl;
+const ZOHO_RECRUIT_RECORD_ATTACHMENT_METADATA_ATTACH_TYPE_RESUME = 'Resume';
 
 var call$2 = functionCall;
 var anObject$2 = anObject$e;
@@ -2484,6 +2489,109 @@ function getEmailsForRecord(context) {
 function getEmailsForRecordPageFactory(context) {
   return zohoFetchPageFactory(getEmailsForRecord(context));
 }
+function getAttachmentsForRecord(context) {
+  return getRelatedRecordsFunctionFactory(context)({
+    targetModule: ZOHO_RECRUIT_ATTACHMENTS_MODULE
+  });
+}
+function getAttachmentsForRecordPageFactory(context) {
+  return zohoFetchPageFactory(getAttachmentsForRecord(context));
+}
+/**
+ * Maximum attachment size allowed by Zoho Recruit.
+ *
+ * 20MB
+ */
+const ZOHO_RECRUIT_ATTACHMENT_MAX_SIZE = 20 * 1024 * 1024;
+/**
+ * Uploads an attachment to a record.
+ *
+ * https://www.zoho.com/recruit/developer-guide/apiv2/upload-attachment.html
+ *
+ * @param context
+ * @returns
+ */
+function uploadAttachmentForRecord(context) {
+  return input => {
+    const {
+      attachmentCategoryId,
+      attachmentCategoryName,
+      formData
+    } = input;
+    const urlParams = {
+      attachments_category_id: util.joinStringsWithCommas(attachmentCategoryId),
+      attachments_category: util.joinStringsWithCommas(attachmentCategoryName),
+      attachment_url: input.attachmentUrl
+    };
+    if (!urlParams.attachments_category_id?.length && !urlParams.attachments_category?.length) {
+      throw new Error('attachmentCategoryId or attachmentCategoryName must be provided and not empty.');
+    }
+    if (formData != null) {
+      delete urlParams.attachment_url;
+    }
+    const url = `https://recruitsandbox.zoho.com/recruit/v2/${input.module}/${input.id}/${ZOHO_RECRUIT_ATTACHMENTS_MODULE}?${fetch.makeUrlSearchParams(urlParams).toString()}`;
+    let response;
+    if (urlParams.attachment_url) {
+      response = context.fetch(url, {
+        method: 'POST'
+      });
+    } else if (formData != null) {
+      throw new Error('unsupported currently. Use the attachmentUrl parameter instead.');
+      // There is something weird going on with sending requests this way and zoho's server is rejecting it.
+      /*
+      response = context.fetch(url, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'multipart/form-data',
+          'content-length': '210'
+        },
+        body: formData
+      });
+      */
+      /*
+      const fullUrl = (context.config.apiUrl as string) + url;
+      const accessToken = await context.accessTokenStringFactory();
+             response = fetch(fullUrl, {
+        headers: {
+          Authorization: `Bearer ${accessToken}`
+        },
+        body: formData,
+        method: 'POST'
+      });
+             console.log({ response });
+      */
+    } else {
+      throw new Error('body or attachmentUrl must be provided.');
+    }
+    return response;
+  };
+}
+/**
+ * Downloads an attachment from a record.
+ *
+ * https://www.zoho.com/recruit/developer-guide/apiv2/download-attachments.html
+ *
+ * @param context
+ * @returns
+ */
+function downloadAttachmentForRecord(context) {
+  return input => context.fetch(`/v2/${input.module}/${input.id}/${ZOHO_RECRUIT_ATTACHMENTS_MODULE}/${input.attachment_id}`, {
+    method: 'GET'
+  }).then(fetch.parseFetchFileResponse);
+}
+/**
+ * Deletes an attachment from a record.
+ *
+ * https://www.zoho.com/recruit/developer-guide/apiv2/delete-attachments.html
+ *
+ * @param context
+ * @returns
+ */
+function deleteAttachmentFromRecord(context) {
+  return input => context.fetch(`/v2/${input.module}/${input.id}/${ZOHO_RECRUIT_ATTACHMENTS_MODULE}/${input.attachment_id}`, {
+    method: 'DELETE'
+  });
+}
 class ZohoRecruitExecuteRestApiFunctionError extends makeError.BaseError {
   constructor(error) {
     super(`An error occured during the execution of the function. Code: ${error.code}, Message: ${error.message}`);
@@ -2935,6 +3043,7 @@ function zohoRecruitFactory(factoryConfig) {
     const recruitContext = {
       fetch: fetch$1,
       fetchJson,
+      accessTokenStringFactory,
       config: {
         ...config,
         apiUrl
@@ -3140,10 +3249,13 @@ exports.ZOHO_RATE_LIMIT_LIMIT_HEADER = ZOHO_RATE_LIMIT_LIMIT_HEADER;
 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_ATTACHMENTS_MODULE = ZOHO_RECRUIT_ATTACHMENTS_MODULE;
+exports.ZOHO_RECRUIT_ATTACHMENT_MAX_SIZE = ZOHO_RECRUIT_ATTACHMENT_MAX_SIZE;
 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_RECORD_ATTACHMENT_METADATA_ATTACH_TYPE_RESUME = ZOHO_RECRUIT_RECORD_ATTACHMENT_METADATA_ATTACH_TYPE_RESUME;
 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;
@@ -3172,11 +3284,15 @@ exports.associateCandidateRecordsWithJobOpenings = associateCandidateRecordsWith
 exports.createNotes = createNotes;
 exports.createNotesForRecord = createNotesForRecord;
 exports.createTagsForModule = createTagsForModule;
+exports.deleteAttachmentFromRecord = deleteAttachmentFromRecord;
 exports.deleteNotes = deleteNotes;
 exports.deleteRecord = deleteRecord;
+exports.downloadAttachmentForRecord = downloadAttachmentForRecord;
 exports.emptyZohoPageResult = emptyZohoPageResult;
 exports.escapeZohoFieldValueForCriteriaString = escapeZohoFieldValueForCriteriaString;
 exports.executeRestApiFunction = executeRestApiFunction;
+exports.getAttachmentsForRecord = getAttachmentsForRecord;
+exports.getAttachmentsForRecordPageFactory = getAttachmentsForRecordPageFactory;
 exports.getEmailsForRecord = getEmailsForRecord;
 exports.getEmailsForRecordPageFactory = getEmailsForRecordPageFactory;
 exports.getNotesForRecord = getNotesForRecord;
@@ -3212,6 +3328,7 @@ exports.searchRecords = searchRecords;
 exports.searchRecordsPageFactory = searchRecordsPageFactory;
 exports.tryFindZohoServerErrorData = tryFindZohoServerErrorData;
 exports.updateRecord = updateRecord;
+exports.uploadAttachmentForRecord = uploadAttachmentForRecord;
 exports.upsertRecord = upsertRecord;
 exports.zohoAccessTokenStringFactory = zohoAccessTokenStringFactory;
 exports.zohoAccountsApiFetchJsonInput = zohoAccountsApiFetchJsonInput;

package/index.esm.js

@@ -1,5 +1,5 @@
-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 { getNextPageNumber, isStandardInternetAccessibleWebsiteUrl, escapeStringCharactersFunction, filterMaybeArrayValues, asArray, MS_IN_MINUTE, joinStringsWithCommas, separateValues, resetPeriodPromiseRateLimiter, MS_IN_SECOND } from '@dereekb/util';
+import { fetchPageFactory, FetchResponseError, makeUrlSearchParams, parseFetchFileResponse, FetchRequestFactoryError, rateLimitedFetchHandler, fetchJsonFunction, returnNullHandleFetchJsonParseErrorFunction, fetchApiFetchService } from '@dereekb/util/fetch';
 import { BaseError } from 'make-error';
 
 var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
@@ -1808,10 +1808,15 @@ const ZOHO_RECRUIT_NOTES_MODULE = 'Notes';
  * Emails module name
  */
 const ZOHO_RECRUIT_EMAILS_MODULE = 'Emails';
+/**
+ * Attachments module name
+ */
+const ZOHO_RECRUIT_ATTACHMENTS_MODULE = 'Attachments';
 /**
  * Returns true if it is a valid ZohoRecruitValidUrl.
  */
 const isZohoRecruitValidUrl = isStandardInternetAccessibleWebsiteUrl;
+const ZOHO_RECRUIT_RECORD_ATTACHMENT_METADATA_ATTACH_TYPE_RESUME = 'Resume';
 
 var call$2 = functionCall;
 var anObject$2 = anObject$e;
@@ -2482,6 +2487,109 @@ function getEmailsForRecord(context) {
 function getEmailsForRecordPageFactory(context) {
   return zohoFetchPageFactory(getEmailsForRecord(context));
 }
+function getAttachmentsForRecord(context) {
+  return getRelatedRecordsFunctionFactory(context)({
+    targetModule: ZOHO_RECRUIT_ATTACHMENTS_MODULE
+  });
+}
+function getAttachmentsForRecordPageFactory(context) {
+  return zohoFetchPageFactory(getAttachmentsForRecord(context));
+}
+/**
+ * Maximum attachment size allowed by Zoho Recruit.
+ *
+ * 20MB
+ */
+const ZOHO_RECRUIT_ATTACHMENT_MAX_SIZE = 20 * 1024 * 1024;
+/**
+ * Uploads an attachment to a record.
+ *
+ * https://www.zoho.com/recruit/developer-guide/apiv2/upload-attachment.html
+ *
+ * @param context
+ * @returns
+ */
+function uploadAttachmentForRecord(context) {
+  return input => {
+    const {
+      attachmentCategoryId,
+      attachmentCategoryName,
+      formData
+    } = input;
+    const urlParams = {
+      attachments_category_id: joinStringsWithCommas(attachmentCategoryId),
+      attachments_category: joinStringsWithCommas(attachmentCategoryName),
+      attachment_url: input.attachmentUrl
+    };
+    if (!urlParams.attachments_category_id?.length && !urlParams.attachments_category?.length) {
+      throw new Error('attachmentCategoryId or attachmentCategoryName must be provided and not empty.');
+    }
+    if (formData != null) {
+      delete urlParams.attachment_url;
+    }
+    const url = `https://recruitsandbox.zoho.com/recruit/v2/${input.module}/${input.id}/${ZOHO_RECRUIT_ATTACHMENTS_MODULE}?${makeUrlSearchParams(urlParams).toString()}`;
+    let response;
+    if (urlParams.attachment_url) {
+      response = context.fetch(url, {
+        method: 'POST'
+      });
+    } else if (formData != null) {
+      throw new Error('unsupported currently. Use the attachmentUrl parameter instead.');
+      // There is something weird going on with sending requests this way and zoho's server is rejecting it.
+      /*
+      response = context.fetch(url, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'multipart/form-data',
+          'content-length': '210'
+        },
+        body: formData
+      });
+      */
+      /*
+      const fullUrl = (context.config.apiUrl as string) + url;
+      const accessToken = await context.accessTokenStringFactory();
+             response = fetch(fullUrl, {
+        headers: {
+          Authorization: `Bearer ${accessToken}`
+        },
+        body: formData,
+        method: 'POST'
+      });
+             console.log({ response });
+      */
+    } else {
+      throw new Error('body or attachmentUrl must be provided.');
+    }
+    return response;
+  };
+}
+/**
+ * Downloads an attachment from a record.
+ *
+ * https://www.zoho.com/recruit/developer-guide/apiv2/download-attachments.html
+ *
+ * @param context
+ * @returns
+ */
+function downloadAttachmentForRecord(context) {
+  return input => context.fetch(`/v2/${input.module}/${input.id}/${ZOHO_RECRUIT_ATTACHMENTS_MODULE}/${input.attachment_id}`, {
+    method: 'GET'
+  }).then(parseFetchFileResponse);
+}
+/**
+ * Deletes an attachment from a record.
+ *
+ * https://www.zoho.com/recruit/developer-guide/apiv2/delete-attachments.html
+ *
+ * @param context
+ * @returns
+ */
+function deleteAttachmentFromRecord(context) {
+  return input => context.fetch(`/v2/${input.module}/${input.id}/${ZOHO_RECRUIT_ATTACHMENTS_MODULE}/${input.attachment_id}`, {
+    method: 'DELETE'
+  });
+}
 class ZohoRecruitExecuteRestApiFunctionError extends BaseError {
   constructor(error) {
     super(`An error occured during the execution of the function. Code: ${error.code}, Message: ${error.message}`);
@@ -2933,6 +3041,7 @@ function zohoRecruitFactory(factoryConfig) {
     const recruitContext = {
       fetch,
       fetchJson,
+      accessTokenStringFactory,
       config: {
         ...config,
         apiUrl
@@ -3119,4 +3228,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_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 };
+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_ATTACHMENTS_MODULE, ZOHO_RECRUIT_ATTACHMENT_MAX_SIZE, ZOHO_RECRUIT_CANDIDATES_MODULE, ZOHO_RECRUIT_EMAILS_MODULE, ZOHO_RECRUIT_JOB_OPENINGS_MODULE, ZOHO_RECRUIT_NOTES_MODULE, ZOHO_RECRUIT_RECORD_ATTACHMENT_METADATA_ATTACH_TYPE_RESUME, 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, deleteAttachmentFromRecord, deleteNotes, deleteRecord, downloadAttachmentForRecord, emptyZohoPageResult, escapeZohoFieldValueForCriteriaString, executeRestApiFunction, getAttachmentsForRecord, getAttachmentsForRecordPageFactory, 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, uploadAttachmentForRecord, 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,14 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [12.3.8](https://github.com/dereekb/dbx-components/compare/v12.3.7-dev...v12.3.8) (2025-08-14)
+
+
+
+## [12.3.7](https://github.com/dereekb/dbx-components/compare/v12.3.6-dev...v12.3.7) (2025-08-14)
+
+
+
 ## [12.3.6](https://github.com/dereekb/dbx-components/compare/v12.3.5-dev...v12.3.6) (2025-08-13)
 
 

package/nestjs/package.json

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

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

@@ -19,6 +19,11 @@ export declare class ZohoRecruitApi {
     get getRelatedRecordsFunctionFactory(): import("@dereekb/zoho").ZohoRecruitGetRelatedRecordsFunctionFactory;
     get getEmailsForRecord(): import("@dereekb/zoho").ZohoRecruitGetEmailsForRecordFunction;
     get getEmailsForRecordPageFactory(): import("@dereekb/zoho").GetEmailsForRecordPageFactory;
+    get getAttachmentsForRecord(): import("@dereekb/zoho").ZohoRecruitGetAttachmentsForRecordFunction;
+    get getAttachmentsForRecordPageFactory(): import("@dereekb/zoho").GetAttachmentsForRecordPageFactory;
+    get uploadAttachmentForRecord(): import("@dereekb/zoho").ZohoRecruitUploadAttachmentForRecordFunction;
+    get downloadAttachmentForRecord(): import("@dereekb/zoho").ZohoRecruitDownloadAttachmentForRecordFunction;
+    get deleteAttachmentFromRecord(): import("@dereekb/zoho").ZohoRecruitDeleteAttachmentFromRecordFunction;
     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;

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

@@ -58,6 +58,21 @@ let ZohoRecruitApi = class ZohoRecruitApi {
     get getEmailsForRecordPageFactory() {
         return (0, zoho_1.getEmailsForRecordPageFactory)(this.recruitContext);
     }
+    get getAttachmentsForRecord() {
+        return (0, zoho_1.getAttachmentsForRecord)(this.recruitContext);
+    }
+    get getAttachmentsForRecordPageFactory() {
+        return (0, zoho_1.getAttachmentsForRecordPageFactory)(this.recruitContext);
+    }
+    get uploadAttachmentForRecord() {
+        return (0, zoho_1.uploadAttachmentForRecord)(this.recruitContext);
+    }
+    get downloadAttachmentForRecord() {
+        return (0, zoho_1.downloadAttachmentForRecord)(this.recruitContext);
+    }
+    get deleteAttachmentFromRecord() {
+        return (0, zoho_1.deleteAttachmentFromRecord)(this.recruitContext);
+    }
     get createNotes() {
         return (0, zoho_1.createNotes)(this.recruitContext);
     }

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":";;;;AAAA,2CAAoD;AACpD,wCA6BuB;AACvB,qDAA4D;AAC5D,2DAA2D;AAGpD,IAAM,cAAc,GAApB,MAAM,cAAc;IAYoB;IACT;IAZ3B,WAAW,CAAc;IAElC,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;IACzC,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,eAAe,CAAC;IACzD,CAAC;IAED,YAC6C,MAAgC,EACzC,eAAgC;QADvB,WAAM,GAAN,MAAM,CAA0B;QACzC,oBAAe,GAAf,eAAe,CAAiB;QAElE,IAAI,CAAC,WAAW,GAAG,IAAA,yBAAkB,EAAC;YACpC,GAAG,MAAM,CAAC,aAAa;YACvB,eAAe,EAAE,eAAe,CAAC,eAAe;SACjD,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACzB,CAAC;IAED,kBAAkB;IAClB,IAAI,YAAY;QACd,OAAO,IAAA,mBAAY,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAA,mBAAY,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAA,mBAAY,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAA,mBAAY,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAA,oBAAa,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAA,iBAAU,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAA,oBAAa,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,wBAAwB;QAC1B,OAAO,IAAA,+BAAwB,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,gCAAgC;QAClC,OAAO,IAAA,uCAAgC,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,kBAAkB;QACpB,OAAO,IAAA,yBAAkB,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,6BAA6B;QAC/B,OAAO,IAAA,oCAA6B,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAA,kBAAW,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAA,kBAAW,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,oBAAoB;QACtB,OAAO,IAAA,2BAAoB,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAA,wBAAiB,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,4BAA4B;QAC9B,OAAO,IAAA,mCAA4B,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,sBAAsB;QACxB,OAAO,IAAA,6BAAsB,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,wCAAwC;QAC1C,OAAO,IAAA,+CAAwC,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,0CAA0C;QAC5C,OAAO,IAAA,iDAA0C,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,qDAAqD;QACvD,OAAO,IAAA,4DAAqD,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,0CAA0C;QAC5C,OAAO,IAAA,iDAA0C,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,qDAAqD;QACvD,OAAO,IAAA,4DAAqD,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,mBAAmB;QACrB,OAAO,IAAA,0BAAmB,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,gBAAgB;QAClB,OAAO,IAAA,uBAAgB,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,gBAAgB;QAClB,OAAO,IAAA,uBAAgB,EAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC/C,CAAC;CACF,CAAA;AAzHY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;IAaR,mBAAA,IAAA,eAAM,EAAC,yCAAwB,CAAC,CAAA;IAChC,mBAAA,IAAA,eAAM,EAAC,8BAAe,CAAC,CAAA;6CAD2B,yCAAwB;QACxB,8BAAe;GAbzD,cAAc,CAyH1B"}
+{"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.3.6",
+  "version": "12.3.8",
   "exports": {
     ".": {
       "types": "./src/index.d.ts",

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

@@ -1,9 +1,9 @@
 import { ZohoDataArrayResultRef, ZohoPageFilter, ZohoPageResult } from './../zoho.api.page';
-import { FetchJsonBody, FetchJsonInput, FetchPage, FetchPageFactory, FetchPageFactoryOptions, makeUrlSearchParams } from '@dereekb/util/fetch';
+import { FetchFileResponse, FetchJsonBody, FetchJsonInput, FetchPage, FetchPageFactory, FetchPageFactoryOptions, makeUrlSearchParams } from '@dereekb/util/fetch';
 import { ZohoRecruitConfigApiUrlInput, ZohoRecruitContext } from './recruit.config';
-import { ZohoRecruitCommaSeparateFieldNames, ZohoRecruitCustomViewId, ZohoRecruitDraftOrSaveState, ZohoRecruitFieldName, ZohoRecruitModuleNameRef, ZohoRecruitChangeObjectDetails, ZohoRecruitRecord, ZohoRecruitRecordId, ZohoRecruitTerritoryId, ZohoRecruitTrueFalseBoth, ZohoRecruitRestFunctionApiName, ZohoRecruitUserId, ZohoRecruitModuleName, ZohoRecruitRecordEmailMetadata } from './recruit';
+import { ZohoRecruitCommaSeparateFieldNames, ZohoRecruitCustomViewId, ZohoRecruitDraftOrSaveState, ZohoRecruitFieldName, ZohoRecruitModuleNameRef, ZohoRecruitChangeObjectDetails, ZohoRecruitRecord, ZohoRecruitRecordId, ZohoRecruitTerritoryId, ZohoRecruitTrueFalseBoth, ZohoRecruitRestFunctionApiName, ZohoRecruitUserId, ZohoRecruitModuleName, ZohoRecruitRecordEmailMetadata, ZohoRecruitRecordAttachmentMetadata, ZohoRecruitAttachmentRecordId, ZohoRecruitAttachmentCategoryId, KnownZohoRecruitAttachmentCategoryName } from './recruit';
 import { ZohoRecruitSearchRecordsCriteriaTreeElement } from './recruit.criteria';
-import { ArrayOrValue, EmailAddress, Maybe, PhoneNumber, SortingOrder, UniqueModelWithId } from '@dereekb/util';
+import { ArrayOrValue, EmailAddress, Maybe, PhoneNumber, SortingOrder, UniqueModelWithId, WebsiteUrlWithPrefix } from '@dereekb/util';
 import { ZohoServerErrorDataWithDetails, ZohoServerErrorStatus, ZohoServerSuccessCode, ZohoServerSuccessStatus } from '../zoho.error.api';
 import { ZohoDateTimeString } from '../zoho.type';
 import { BaseError } from 'make-error';
@@ -203,6 +203,87 @@ export type ZohoRecruitGetEmailsForRecordFunction = (input: ZohoRecruitGetEmails
 export declare function getEmailsForRecord(context: ZohoRecruitContext): ZohoRecruitGetEmailsForRecordFunction;
 export type GetEmailsForRecordPageFactory = FetchPageFactory<ZohoRecruitGetEmailsForRecordRequest, ZohoRecruitGetEmailsForRecordResponse>;
 export declare function getEmailsForRecordPageFactory(context: ZohoRecruitContext): GetEmailsForRecordPageFactory;
+export type ZohoRecruitGetAttachmentsForRecordRequest = ZohoRecruitGetRelatedRecordsRequest;
+export type ZohoRecruitGetAttachmentsForRecordResponse = ZohoPageResult<ZohoRecruitRecordAttachmentMetadata>;
+export type ZohoRecruitGetAttachmentsForRecordFunction = (input: ZohoRecruitGetAttachmentsForRecordRequest) => Promise<ZohoRecruitGetAttachmentsForRecordResponse>;
+export declare function getAttachmentsForRecord(context: ZohoRecruitContext): ZohoRecruitGetAttachmentsForRecordFunction;
+export type GetAttachmentsForRecordPageFactory = FetchPageFactory<ZohoRecruitGetAttachmentsForRecordRequest, ZohoRecruitGetAttachmentsForRecordResponse>;
+export declare function getAttachmentsForRecordPageFactory(context: ZohoRecruitContext): GetAttachmentsForRecordPageFactory;
+/**
+ * Maximum attachment size allowed by Zoho Recruit.
+ *
+ * 20MB
+ */
+export declare const ZOHO_RECRUIT_ATTACHMENT_MAX_SIZE: number;
+export interface ZohoRecruitUploadAttachmentForRecordRequest extends ZohoRecruitGetRecordByIdInput {
+    /**
+     * Requires the use of a FormData object.
+     *
+     * Max of 20MB are allowed
+     *
+     * @deprecated Use attachmentUrl instead for now.
+     */
+    readonly formData?: FormData;
+    /**
+     * File url to pull the file from.
+     *
+     * Either this or formData must be provided.
+     */
+    readonly attachmentUrl?: WebsiteUrlWithPrefix;
+    /**
+     * The category id(s) of the attachment.
+     *
+     * Either this or attachments_category must be provided.
+     */
+    readonly attachmentCategoryId?: ArrayOrValue<ZohoRecruitAttachmentCategoryId>;
+    /**
+     * The category name(s) of the attachment.
+     *
+     * Either this or attachments_category_id must be provided.
+     *
+     * Example: "Resume"
+     */
+    readonly attachmentCategoryName?: ArrayOrValue<KnownZohoRecruitAttachmentCategoryName>;
+}
+export type ZohoRecruitUploadAttachmentForRecordResponse = Response;
+export type ZohoRecruitUploadAttachmentForRecordFunction = (input: ZohoRecruitUploadAttachmentForRecordRequest) => Promise<ZohoRecruitUploadAttachmentForRecordResponse>;
+/**
+ * Uploads an attachment to a record.
+ *
+ * https://www.zoho.com/recruit/developer-guide/apiv2/upload-attachment.html
+ *
+ * @param context
+ * @returns
+ */
+export declare function uploadAttachmentForRecord(context: ZohoRecruitContext): ZohoRecruitUploadAttachmentForRecordFunction;
+export interface ZohoRecruitDownloadAttachmentForRecordRequest extends ZohoRecruitGetRecordByIdInput {
+    readonly attachment_id: ZohoRecruitAttachmentRecordId;
+}
+export type ZohoRecruitDownloadAttachmentForRecordResponse = FetchFileResponse;
+export type ZohoRecruitDownloadAttachmentForRecordFunction = (input: ZohoRecruitDownloadAttachmentForRecordRequest) => Promise<ZohoRecruitDownloadAttachmentForRecordResponse>;
+/**
+ * Downloads an attachment from a record.
+ *
+ * https://www.zoho.com/recruit/developer-guide/apiv2/download-attachments.html
+ *
+ * @param context
+ * @returns
+ */
+export declare function downloadAttachmentForRecord(context: ZohoRecruitContext): ZohoRecruitDownloadAttachmentForRecordFunction;
+export interface ZohoRecruitDeleteAttachmentFromRecordRequest extends ZohoRecruitGetRecordByIdInput {
+    readonly attachment_id: ZohoRecruitAttachmentRecordId;
+}
+export type ZohoRecruitDeleteAttachmentFromRecordResponse = Response;
+export type ZohoRecruitDeleteAttachmentFromRecordFunction = (input: ZohoRecruitDeleteAttachmentFromRecordRequest) => Promise<ZohoRecruitDeleteAttachmentFromRecordResponse>;
+/**
+ * Deletes an attachment from a record.
+ *
+ * https://www.zoho.com/recruit/developer-guide/apiv2/delete-attachments.html
+ *
+ * @param context
+ * @returns
+ */
+export declare function deleteAttachmentFromRecord(context: ZohoRecruitContext): ZohoRecruitDeleteAttachmentFromRecordFunction;
 export type ZohoRecruitExecuteRestApiFunctionRequest = ZohoRecruitExecuteRestApiFunctionNormalRequest | ZohoRecruitExecuteRestApiFunctionApiSpecificRequest;
 export interface ZohoRecruitExecuteRestApiFunctionNormalRequest {
     readonly functionName: ZohoRecruitRestFunctionApiName;

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

@@ -1,7 +1,7 @@
 import { FactoryWithRequiredInput } from '@dereekb/util';
 import { ConfiguredFetch, FetchJsonFunction } from '@dereekb/util/fetch';
 import { ZohoApiUrl, ZohoApiUrlKey, ZohoConfig, ZohoApiServiceName } from '../zoho.config';
-import { ZohoServiceAccessTokenKey } from '../accounts';
+import { ZohoAccessTokenStringFactory, ZohoServiceAccessTokenKey } from '../accounts';
 import { ZohoRateLimiterRef } from '../zoho.limit';
 export declare const ZOHO_RECRUIT_SERVICE_NAME: ZohoApiServiceName | ZohoServiceAccessTokenKey;
 export type ZohoRecruitApiUrl = ZohoApiUrl;
@@ -16,6 +16,7 @@ export type ZohoRecruitFetchFactory = FactoryWithRequiredInput<ConfiguredFetch,
 export interface ZohoRecruitContext extends ZohoRateLimiterRef {
     readonly fetch: ConfiguredFetch;
     readonly fetchJson: FetchJsonFunction;
+    readonly accessTokenStringFactory: ZohoAccessTokenStringFactory;
     readonly config: ZohoRecruitConfig;
 }
 export interface ZohoRecruitContextRef {

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

@@ -21,6 +21,10 @@ export declare const ZOHO_RECRUIT_NOTES_MODULE = "Notes";
  * Emails module name
  */
 export declare const ZOHO_RECRUIT_EMAILS_MODULE = "Emails";
+/**
+ * Attachments module name
+ */
+export declare const ZOHO_RECRUIT_ATTACHMENTS_MODULE = "Attachments";
 /**
  * Contains a reference to a module.
  */
@@ -183,6 +187,109 @@ export type ZohoRecruitRecordEmailMetadataStatusType = 'sent' | string;
 export interface ZohoRecruitRecordEmailMetadataStatus {
     type: ZohoRecruitRecordEmailMetadataStatusType;
 }
+export declare const ZOHO_RECRUIT_RECORD_ATTACHMENT_METADATA_ATTACH_TYPE_RESUME = "Resume";
+export interface ZohoRecruitRecordAttachmentMetadataAttachType extends ZohoRecruitReferenceData {
+    name: typeof ZOHO_RECRUIT_RECORD_ATTACHMENT_METADATA_ATTACH_TYPE_RESUME | string;
+}
+/**
+ * Record id for an attachment.
+ */
+export type ZohoRecruitAttachmentRecordId = ZohoRecruitRecordId;
+/**
+ * The size of the attachment in bytes, stored as a string.
+ */
+export type ZohoRecruitRecordAttachmentMetadataSize = string;
+/**
+ * Attachment category id
+ */
+export type ZohoRecruitAttachmentCategoryId = string;
+/**
+ * Known attachment category names
+ */
+export type KnownZohoRecruitAttachmentCategoryName = 'Resume' | 'Offer' | 'Contracts' | 'Criminal records' | 'Mandatory reporter' | 'Teaching certification' | 'Health records' | 'Others' | 'Cover Letter' | 'Formatted Resume';
+/**
+ * Attachment category name
+ *
+ * I.E. "Resume"
+ */
+export type ZohoRecruitAttachmentCategoryName = KnownZohoRecruitAttachmentCategoryName | string;
+/**
+ * Metadata for a record's attachment.
+ */
+export interface ZohoRecruitRecordAttachmentMetadata {
+    /**
+     * The type of attachment
+     */
+    $attach_type: ZohoRecruitRecordAttachmentMetadataAttachType;
+    /**
+     * Last time the attachment was modified
+     */
+    Modified_Time: ISO8601DateString;
+    /**
+     * The category of the attachment
+     */
+    Category: ZohoRecruitRecordAttachmentMetadataAttachType;
+    /**
+     * The name of the attachment
+     */
+    File_Name: string;
+    /**
+     * The size of the attachment in bytes, stored as a string.
+     */
+    Size: ZohoRecruitRecordAttachmentMetadataSize;
+    /**
+     * The time the attachment was created
+     */
+    Created_Time: ISO8601DateString;
+    /**
+     * The parent record id for this attachment
+     */
+    Parent_Id: ZohoRecruitRecordId;
+    /**
+     * Owner of the attachment
+     */
+    Attachment_Owner: ZohoRecruitUserReferenceData;
+    /**
+     * Internal file identifier for the attachment
+     */
+    $file_id: string;
+    /**
+     * Type marker (e.g., "Attachment")
+     */
+    $type: 'Attachment' | string;
+    /**
+     * Direct URL to the attachment, when available
+     */
+    Attachment_URL: string | null;
+    /**
+     * User who last modified this attachment
+     */
+    Modified_By: ZohoRecruitUserReferenceData;
+    /**
+     * Attachment record id
+     */
+    id: ZohoRecruitAttachmentRecordId;
+    /**
+     * User who created this attachment
+     */
+    Created_By: ZohoRecruitUserReferenceData;
+    /**
+     * Whether the attachment is editable
+     */
+    $editable: boolean;
+    /**
+     * Module this attachment belongs to (e.g., Candidates)
+     */
+    $se_module: ZohoRecruitModuleName;
+    /**
+     * Link URL when the attachment is a link
+     */
+    $link_url?: string | null;
+    /**
+     * Number of linked documents
+     */
+    $link_docs: number;
+}
 /**
  * Update details returned by the server for an updated record.
  *