@dereekb/zoho 13.0.6 → 13.0.7

package/nestjs/index.cjs.js

@@ -416,26 +416,349 @@ exports.ZohoAccountsApi = __decorate([
 ], exports.ZohoAccountsApi);
 
 /**
- * Configuration for ZohoRecruitService
+ * Abstract configuration class for the NestJS Zoho CRM service.
+ *
+ * Used as a DI token so that applications can provide their own config values
+ * while keeping the expected shape consistent.
+ */
+class ZohoCrmServiceConfig {
+    /**
+     * Zoho CRM API connection settings (endpoint URL, etc.).
+     */
+    zohoCrm;
+    /**
+     * Optional factory-level overrides applied when creating the underlying CRM client.
+     */
+    factoryConfig;
+    /**
+     * Validates that the required Zoho CRM connection fields are present and well-formed.
+     */
+    static assertValidConfig(config) {
+        assertValidZohoConfig(config.zohoCrm);
+    }
+}
+
+/**
+ * NestJS injectable service that wraps the Zoho CRM API.
+ *
+ * Provides convenient accessor getters for all CRM operations, each bound
+ * to the authenticated CRM context created during construction.
+ */
+exports.ZohoCrmApi = class ZohoCrmApi {
+    config;
+    zohoAccountsApi;
+    /**
+     * Underlying Zoho CRM client instance, initialized from the injected config and accounts context.
+     */
+    zohoCrm;
+    /**
+     * The authenticated CRM context used by all operation accessors.
+     */
+    get crmContext() {
+        return this.zohoCrm.crmContext;
+    }
+    /**
+     * Rate limiter shared across all CRM requests to respect Zoho API quotas.
+     */
+    get zohoRateLimiter() {
+        return this.zohoCrm.crmContext.zohoRateLimiter;
+    }
+    /**
+     * Initializes the CRM client by combining the service config with the
+     * accounts context for OAuth token management.
+     */
+    constructor(config, zohoAccountsApi) {
+        this.config = config;
+        this.zohoAccountsApi = zohoAccountsApi;
+        this.zohoCrm = zoho.zohoCrmFactory({
+            ...config.factoryConfig,
+            accountsContext: zohoAccountsApi.accountsContext
+        })(config.zohoCrm);
+    }
+    // MARK: Accessors
+    /** Configured pass-through for {@link zohoCrmInsertRecord}. */
+    get insertRecord() {
+        return zoho.zohoCrmInsertRecord(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmUpsertRecord}. */
+    get upsertRecord() {
+        return zoho.zohoCrmUpsertRecord(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmUpdateRecord}. */
+    get updateRecord() {
+        return zoho.zohoCrmUpdateRecord(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmDeleteRecord}. */
+    get deleteRecord() {
+        return zoho.zohoCrmDeleteRecord(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmGetRecordById}. */
+    get getRecordById() {
+        return zoho.zohoCrmGetRecordById(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmGetRecords}. */
+    get getRecords() {
+        return zoho.zohoCrmGetRecords(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmSearchRecords}. */
+    get searchRecords() {
+        return zoho.zohoCrmSearchRecords(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmSearchRecordsPageFactory}. */
+    get searchRecordsPageFactory() {
+        return zoho.zohoCrmSearchRecordsPageFactory(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmGetRelatedRecordsFunctionFactory}. */
+    get getRelatedRecordsFunctionFactory() {
+        return zoho.zohoCrmGetRelatedRecordsFunctionFactory(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmGetEmailsForRecord}. */
+    get getEmailsForRecord() {
+        return zoho.zohoCrmGetEmailsForRecord(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmGetEmailsForRecordPageFactory}. */
+    get getEmailsForRecordPageFactory() {
+        return zoho.zohoCrmGetEmailsForRecordPageFactory(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmGetAttachmentsForRecord}. */
+    get getAttachmentsForRecord() {
+        return zoho.zohoCrmGetAttachmentsForRecord(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmGetAttachmentsForRecordPageFactory}. */
+    get getAttachmentsForRecordPageFactory() {
+        return zoho.zohoCrmGetAttachmentsForRecordPageFactory(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmUploadAttachmentForRecord}. */
+    get uploadAttachmentForRecord() {
+        return zoho.zohoCrmUploadAttachmentForRecord(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmDownloadAttachmentForRecord}. */
+    get downloadAttachmentForRecord() {
+        return zoho.zohoCrmDownloadAttachmentForRecord(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmDeleteAttachmentFromRecord}. */
+    get deleteAttachmentFromRecord() {
+        return zoho.zohoCrmDeleteAttachmentFromRecord(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmCreateNotes}. */
+    get createNotes() {
+        return zoho.zohoCrmCreateNotes(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmDeleteNotes}. */
+    get deleteNotes() {
+        return zoho.zohoCrmDeleteNotes(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmCreateNotesForRecord}. */
+    get createNotesForRecord() {
+        return zoho.zohoCrmCreateNotesForRecord(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmGetNotesForRecord}. */
+    get getNotesForRecord() {
+        return zoho.zohoCrmGetNotesForRecord(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmGetNotesForRecordPageFactory}. */
+    get getNotesForRecordPageFactory() {
+        return zoho.zohoCrmGetNotesForRecordPageFactory(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmExecuteRestApiFunction}. */
+    get executeRestApiFunction() {
+        return zoho.zohoCrmExecuteRestApiFunction(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmCreateTagsForModule}. */
+    get createTagsForModule() {
+        return zoho.zohoCrmCreateTagsForModule(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmDeleteTag}. */
+    get deleteTag() {
+        return zoho.zohoCrmDeleteTag(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmGetTagsForModule}. */
+    get getTagsForModule() {
+        return zoho.zohoCrmGetTagsForModule(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmAddTagsToRecords}. */
+    get addTagsToRecords() {
+        return zoho.zohoCrmAddTagsToRecords(this.crmContext);
+    }
+    /** Configured pass-through for {@link zohoCrmRemoveTagsFromRecords}. */
+    get removeTagsFromRecords() {
+        return zoho.zohoCrmRemoveTagsFromRecords(this.crmContext);
+    }
+};
+exports.ZohoCrmApi = __decorate([
+    common.Injectable(),
+    __param(0, common.Inject(ZohoCrmServiceConfig)),
+    __param(1, common.Inject(exports.ZohoAccountsApi)),
+    __metadata("design:paramtypes", [ZohoCrmServiceConfig,
+        exports.ZohoAccountsApi])
+], exports.ZohoCrmApi);
+
+// MARK: Provider Factories
+/**
+ * Reads Zoho CRM connection settings from the NestJS ConfigService
+ * and returns a validated service config.
+ *
+ * Resolves the API URL via environment variables following the naming convention
+ * `ZOHO_CRM_API_URL` (service-specific) or `ZOHO_API_URL` (shared fallback).
+ *
+ * @param configService - NestJS config service populated with Zoho environment variables
+ * @returns Validated Zoho CRM service configuration
+ * @throws {Error} If required config values (e.g. API URL) are missing
+ *
+ * @example
+ * ```typescript
+ * {
+ *   provide: ZohoCrmServiceConfig,
+ *   inject: [ConfigService],
+ *   useFactory: zohoCrmServiceConfigFactory
+ * }
+ * ```
+ */
+function zohoCrmServiceConfigFactory(configService) {
+    const getFromConfigService = zohoConfigServiceReaderFunction(zoho.ZOHO_CRM_SERVICE_NAME, configService);
+    const config = {
+        zohoCrm: {
+            apiUrl: getFromConfigService(ZOHO_API_URL_CONFIG_KEY)
+        }
+    };
+    ZohoCrmServiceConfig.assertValidConfig(config);
+    return config;
+}
+/**
+ * Reads Zoho Accounts (OAuth) settings scoped to the CRM service from
+ * the NestJS ConfigService and returns an accounts service config.
+ *
+ * @param configService - NestJS config service populated with Zoho OAuth environment variables
+ * @returns Zoho Accounts service config scoped to the CRM service access token
+ *
+ * @example
+ * ```typescript
+ * {
+ *   provide: ZohoAccountsServiceConfig,
+ *   inject: [ConfigService],
+ *   useFactory: zohoCrmAccountServiceConfigFactory
+ * }
+ * ```
+ */
+function zohoCrmAccountServiceConfigFactory(configService) {
+    return zohoAccountsServiceConfigFromConfigService({
+        configService,
+        serviceAccessTokenKey: zoho.ZOHO_CRM_SERVICE_NAME
+    });
+}
+/**
+ * Generates NestJS {@link ModuleMetadata} that wires up the full Zoho CRM stack
+ * (config, accounts, and API service) so consuming modules only need a single import.
+ *
+ * The generated module requires the following dependencies in order to initialize properly:
+ * - {@link ZohoAccountsAccessTokenCacheService}
+ *
+ * Use the `dependencyModule` config option to import a module that exports those dependencies.
+ *
+ * The returned metadata registers {@link ZohoCrmServiceConfig}, {@link ZohoCrmApi},
+ * {@link ZohoAccountsServiceConfig}, and {@link ZohoAccountsApi} as providers, and
+ * exports {@link ZohoCrmApi} by default. Additional imports, exports, and providers
+ * from the config are merged in.
+ *
+ * @param config - Module configuration with optional dependency module and extra metadata
+ * @returns Complete NestJS module metadata ready to pass to `@Module()`
+ *
+ * @example
+ * ```typescript
+ * const cacheService = fileZohoAccountsAccessTokenCacheService();
+ *
+ * @Module({
+ *   providers: [
+ *     {
+ *       provide: ZohoAccountsAccessTokenCacheService,
+ *       useValue: cacheService
+ *     }
+ *   ],
+ *   exports: [ZohoAccountsAccessTokenCacheService]
+ * })
+ * export class ZohoCrmDependencyModule {}
+ *
+ * @Module(appZohoCrmModuleMetadata({ dependencyModule: ZohoCrmDependencyModule }))
+ * export class AppZohoCrmModule {}
+ * ```
+ */
+function appZohoCrmModuleMetadata(config$1) {
+    const { dependencyModule, imports, exports: exports$1, providers } = config$1;
+    const dependencyModuleImport = dependencyModule ? [dependencyModule] : [];
+    return {
+        imports: [config.ConfigModule, ...dependencyModuleImport, ...(imports ?? [])],
+        exports: [exports.ZohoCrmApi, ...(exports$1 ?? [])],
+        providers: [
+            {
+                provide: ZohoCrmServiceConfig,
+                inject: [config.ConfigService],
+                useFactory: zohoCrmServiceConfigFactory
+            },
+            exports.ZohoCrmApi,
+            // Accounts
+            {
+                provide: ZohoAccountsServiceConfig,
+                inject: [config.ConfigService],
+                useFactory: zohoCrmAccountServiceConfigFactory
+            },
+            exports.ZohoAccountsApi,
+            ...(providers ?? [])
+        ]
+    };
+}
+
+/**
+ * Abstract configuration class for the NestJS Zoho Recruit service.
+ *
+ * Used as a DI token so that applications can provide their own config values
+ * while keeping the expected shape consistent.
  */
 class ZohoRecruitServiceConfig {
+    /**
+     * Zoho Recruit API connection settings (endpoint URL, etc.).
+     */
     zohoRecruit;
+    /**
+     * Optional factory-level overrides applied when creating the underlying Recruit client.
+     */
     factoryConfig;
+    /**
+     * Validates that the required Zoho Recruit connection fields are present and well-formed.
+     */
     static assertValidConfig(config) {
         assertValidZohoConfig(config.zohoRecruit);
     }
 }
 
+/**
+ * NestJS injectable service that wraps the Zoho Recruit API.
+ *
+ * Provides convenient accessor getters for all Recruit operations, each bound
+ * to the authenticated Recruit context created during construction.
+ */
 exports.ZohoRecruitApi = class ZohoRecruitApi {
     config;
     zohoAccountsApi;
+    /**
+     * Underlying Zoho Recruit client instance, initialized from the injected config and accounts context.
+     */
     zohoRecruit;
+    /**
+     * The authenticated Recruit context used by all operation accessors.
+     */
     get recruitContext() {
         return this.zohoRecruit.recruitContext;
     }
+    /**
+     * Rate limiter shared across all Recruit requests to respect Zoho API quotas.
+     */
     get zohoRateLimiter() {
         return this.zohoRecruit.recruitContext.zohoRateLimiter;
     }
+    /**
+     * Initializes the Recruit client by combining the service config with the
+     * accounts context for OAuth token management.
+     */
     constructor(config, zohoAccountsApi) {
         this.config = config;
         this.zohoAccountsApi = zohoAccountsApi;
@@ -445,96 +768,127 @@ exports.ZohoRecruitApi = class ZohoRecruitApi {
         })(config.zohoRecruit);
     }
     // MARK: Accessors
+    /** Configured pass-through for {@link zohoRecruitInsertRecord}. */
     get insertRecord() {
         return zoho.zohoRecruitInsertRecord(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitUpsertRecord}. */
     get upsertRecord() {
         return zoho.zohoRecruitUpsertRecord(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitUpdateRecord}. */
     get updateRecord() {
         return zoho.zohoRecruitUpdateRecord(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitDeleteRecord}. */
     get deleteRecord() {
         return zoho.zohoRecruitDeleteRecord(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitGetRecordById}. */
     get getRecordById() {
         return zoho.zohoRecruitGetRecordById(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitGetRecords}. */
     get getRecords() {
         return zoho.zohoRecruitGetRecords(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitSearchRecords}. */
     get searchRecords() {
         return zoho.zohoRecruitSearchRecords(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitSearchRecordsPageFactory}. */
     get searchRecordsPageFactory() {
         return zoho.zohoRecruitSearchRecordsPageFactory(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitGetRelatedRecordsFunctionFactory}. */
     get getRelatedRecordsFunctionFactory() {
         return zoho.zohoRecruitGetRelatedRecordsFunctionFactory(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitGetEmailsForRecord}. */
     get getEmailsForRecord() {
         return zoho.zohoRecruitGetEmailsForRecord(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitGetEmailsForRecordPageFactory}. */
     get getEmailsForRecordPageFactory() {
         return zoho.zohoRecruitGetEmailsForRecordPageFactory(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitGetAttachmentsForRecord}. */
     get getAttachmentsForRecord() {
         return zoho.zohoRecruitGetAttachmentsForRecord(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitGetAttachmentsForRecordPageFactory}. */
     get getAttachmentsForRecordPageFactory() {
         return zoho.zohoRecruitGetAttachmentsForRecordPageFactory(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitUploadAttachmentForRecord}. */
     get uploadAttachmentForRecord() {
         return zoho.zohoRecruitUploadAttachmentForRecord(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitDownloadAttachmentForRecord}. */
     get downloadAttachmentForRecord() {
         return zoho.zohoRecruitDownloadAttachmentForRecord(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitDeleteAttachmentFromRecord}. */
     get deleteAttachmentFromRecord() {
         return zoho.zohoRecruitDeleteAttachmentFromRecord(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitCreateNotes}. */
     get createNotes() {
         return zoho.zohoRecruitCreateNotes(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitDeleteNotes}. */
     get deleteNotes() {
         return zoho.zohoRecruitDeleteNotes(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitCreateNotesForRecord}. */
     get createNotesForRecord() {
         return zoho.zohoRecruitCreateNotesForRecord(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitGetNotesForRecord}. */
     get getNotesForRecord() {
         return zoho.zohoRecruitGetNotesForRecord(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitGetNotesForRecordPageFactory}. */
     get getNotesForRecordPageFactory() {
         return zoho.zohoRecruitGetNotesForRecordPageFactory(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitExecuteRestApiFunction}. */
     get executeRestApiFunction() {
         return zoho.zohoRecruitExecuteRestApiFunction(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitAssociateCandidateRecordsWithJobOpenings}. */
     get associateCandidateRecordsWithJobOpenings() {
         return zoho.zohoRecruitAssociateCandidateRecordsWithJobOpenings(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitSearchCandidateAssociatedJobOpeningRecords}. */
     get searchCandidateAssociatedJobOpeningRecords() {
         return zoho.zohoRecruitSearchCandidateAssociatedJobOpeningRecords(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitSearchCandidateAssociatedJobOpeningRecordsPageFactory}. */
     get searchCandidateAssociatedJobOpeningRecordsPageFactory() {
         return zoho.zohoRecruitSearchCandidateAssociatedJobOpeningRecordsPageFactory(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitSearchJobOpeningAssociatedCandidateRecords}. */
     get searchJobOpeningAssociatedCandidateRecords() {
         return zoho.zohoRecruitSearchJobOpeningAssociatedCandidateRecords(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitSearchJobOpeningAssociatedCandidateRecordsPageFactory}. */
     get searchJobOpeningAssociatedCandidateRecordsPageFactory() {
         return zoho.zohoRecruitSearchJobOpeningAssociatedCandidateRecordsPageFactory(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitCreateTagsForModule}. */
     get createTagsForModule() {
         return zoho.zohoRecruitCreateTagsForModule(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitGetTagsForModule}. */
     get getTagsForModule() {
         return zoho.zohoRecruitGetTagsForModule(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitAddTagsToRecords}. */
     get addTagsToRecords() {
         return zoho.zohoRecruitAddTagsToRecords(this.recruitContext);
     }
+    /** Configured pass-through for {@link zohoRecruitRemoveTagsFromRecords}. */
     get removeTagsFromRecords() {
         return zoho.zohoRecruitRemoveTagsFromRecords(this.recruitContext);
     }
@@ -548,6 +902,26 @@ exports.ZohoRecruitApi = __decorate([
 ], exports.ZohoRecruitApi);
 
 // MARK: Provider Factories
+/**
+ * Reads Zoho Recruit connection settings from the NestJS ConfigService
+ * and returns a validated service config.
+ *
+ * Resolves the API URL via environment variables following the naming convention
+ * `ZOHO_RECRUIT_API_URL` (service-specific) or `ZOHO_API_URL` (shared fallback).
+ *
+ * @param configService - NestJS config service populated with Zoho environment variables
+ * @returns Validated Zoho Recruit service configuration
+ * @throws {Error} If required config values (e.g. API URL) are missing
+ *
+ * @example
+ * ```typescript
+ * {
+ *   provide: ZohoRecruitServiceConfig,
+ *   inject: [ConfigService],
+ *   useFactory: zohoRecruitServiceConfigFactory
+ * }
+ * ```
+ */
 function zohoRecruitServiceConfigFactory(configService) {
     const getFromConfigService = zohoConfigServiceReaderFunction(zoho.ZOHO_RECRUIT_SERVICE_NAME, configService);
     const config = {
@@ -558,6 +932,22 @@ function zohoRecruitServiceConfigFactory(configService) {
     ZohoRecruitServiceConfig.assertValidConfig(config);
     return config;
 }
+/**
+ * Reads Zoho Accounts (OAuth) settings scoped to the Recruit service from
+ * the NestJS ConfigService and returns an accounts service config.
+ *
+ * @param configService - NestJS config service populated with Zoho OAuth environment variables
+ * @returns Zoho Accounts service config scoped to the Recruit service access token
+ *
+ * @example
+ * ```typescript
+ * {
+ *   provide: ZohoAccountsServiceConfig,
+ *   inject: [ConfigService],
+ *   useFactory: zohoRecruitAccountServiceConfigFactory
+ * }
+ * ```
+ */
 function zohoRecruitAccountServiceConfigFactory(configService) {
     return zohoAccountsServiceConfigFromConfigService({
         configService,
@@ -565,11 +955,40 @@ function zohoRecruitAccountServiceConfigFactory(configService) {
     });
 }
 /**
- * Convenience function used to generate ModuleMetadata for an app's ZohoRecruitModule.
+ * Generates NestJS {@link ModuleMetadata} that wires up the full Zoho Recruit stack
+ * (config, accounts, and API service) so consuming modules only need a single import.
  *
- * @param provide
- * @param useFactory
- * @returns
+ * The generated module requires the following dependencies in order to initialize properly:
+ * - {@link ZohoAccountsAccessTokenCacheService}
+ *
+ * Use the `dependencyModule` config option to import a module that exports those dependencies.
+ *
+ * The returned metadata registers {@link ZohoRecruitServiceConfig}, {@link ZohoRecruitApi},
+ * {@link ZohoAccountsServiceConfig}, and {@link ZohoAccountsApi} as providers, and
+ * exports {@link ZohoRecruitApi} by default. Additional imports, exports, and providers
+ * from the config are merged in.
+ *
+ * @param config - Module configuration with optional dependency module and extra metadata
+ * @returns Complete NestJS module metadata ready to pass to `@Module()`
+ *
+ * @example
+ * ```typescript
+ * const cacheService = fileZohoAccountsAccessTokenCacheService();
+ *
+ * @Module({
+ *   providers: [
+ *     {
+ *       provide: ZohoAccountsAccessTokenCacheService,
+ *       useValue: cacheService
+ *     }
+ *   ],
+ *   exports: [ZohoAccountsAccessTokenCacheService]
+ * })
+ * export class ZohoRecruitDependencyModule {}
+ *
+ * @Module(appZohoRecruitModuleMetadata({ dependencyModule: ZohoRecruitDependencyModule }))
+ * export class AppZohoRecruitModule {}
+ * ```
  */
 function appZohoRecruitModuleMetadata(config$1) {
     const { dependencyModule, imports, exports: exports$1, providers } = config$1;
@@ -596,11 +1015,236 @@ function appZohoRecruitModuleMetadata(config$1) {
     };
 }
 
+/**
+ * Configuration for ZohoSignService
+ */
+class ZohoSignServiceConfig {
+    zohoSign;
+    factoryConfig;
+    static assertValidConfig(config) {
+        assertValidZohoConfig(config.zohoSign);
+    }
+}
+
+/**
+ * NestJS injectable service that wraps the Zoho Sign API.
+ *
+ * Provides convenient accessor getters for all Sign operations, each bound
+ * to the authenticated Sign context created during construction.
+ */
+exports.ZohoSignApi = class ZohoSignApi {
+    config;
+    zohoAccountsApi;
+    /**
+     * Underlying Zoho Sign client instance, initialized from the injected config and accounts context.
+     */
+    zohoSign;
+    /**
+     * The authenticated Sign context used by all operation accessors.
+     */
+    get signContext() {
+        return this.zohoSign.signContext;
+    }
+    /**
+     * Rate limiter shared across all Sign requests to respect Zoho API quotas.
+     */
+    get zohoRateLimiter() {
+        return this.zohoSign.signContext.zohoRateLimiter;
+    }
+    /**
+     * Initializes the Sign client by combining the service config with the
+     * accounts context for OAuth token management.
+     */
+    constructor(config, zohoAccountsApi) {
+        this.config = config;
+        this.zohoAccountsApi = zohoAccountsApi;
+        this.zohoSign = zoho.zohoSignFactory({
+            ...config.factoryConfig,
+            accountsContext: zohoAccountsApi.accountsContext
+        })(config.zohoSign);
+    }
+    // MARK: Accessors
+    /** Configured pass-through for {@link zohoSignGetDocument}. */
+    get getDocument() {
+        return zoho.zohoSignGetDocument(this.signContext);
+    }
+    /** Configured pass-through for {@link zohoSignGetDocuments}. */
+    get getDocuments() {
+        return zoho.zohoSignGetDocuments(this.signContext);
+    }
+    /** Configured pass-through for {@link zohoSignGetDocumentsPageFactory}. */
+    get getDocumentsPageFactory() {
+        return zoho.zohoSignGetDocumentsPageFactory(this.signContext);
+    }
+    /** Configured pass-through for {@link zohoSignGetDocumentFormData}. */
+    get getDocumentFormData() {
+        return zoho.zohoSignGetDocumentFormData(this.signContext);
+    }
+    /** Configured pass-through for {@link zohoSignRetrieveFieldTypes}. */
+    get retrieveFieldTypes() {
+        return zoho.zohoSignRetrieveFieldTypes(this.signContext);
+    }
+    /** Configured pass-through for {@link zohoSignDownloadPdf}. */
+    get downloadPdf() {
+        return zoho.zohoSignDownloadPdf(this.signContext);
+    }
+    /** Configured pass-through for {@link zohoSignDownloadCompletionCertificate}. */
+    get downloadCompletionCertificate() {
+        return zoho.zohoSignDownloadCompletionCertificate(this.signContext);
+    }
+    /** Configured pass-through for {@link zohoSignCreateDocument}. */
+    get createDocument() {
+        return zoho.zohoSignCreateDocument(this.signContext);
+    }
+    /** Configured pass-through for {@link zohoSignUpdateDocument}. */
+    get updateDocument() {
+        return zoho.zohoSignUpdateDocument(this.signContext);
+    }
+    /** Configured pass-through for {@link zohoSignSendDocumentForSignature}. */
+    get sendDocumentForSignature() {
+        return zoho.zohoSignSendDocumentForSignature(this.signContext);
+    }
+    /** Configured pass-through for {@link zohoSignExtendDocument}. */
+    get extendDocument() {
+        return zoho.zohoSignExtendDocument(this.signContext);
+    }
+    /** Configured pass-through for {@link zohoSignDeleteDocument}. */
+    get deleteDocument() {
+        return zoho.zohoSignDeleteDocument(this.signContext);
+    }
+};
+exports.ZohoSignApi = __decorate([
+    common.Injectable(),
+    __param(0, common.Inject(ZohoSignServiceConfig)),
+    __param(1, common.Inject(exports.ZohoAccountsApi)),
+    __metadata("design:paramtypes", [ZohoSignServiceConfig,
+        exports.ZohoAccountsApi])
+], exports.ZohoSignApi);
+
+// MARK: Provider Factories
+/**
+ * Reads Zoho Sign connection settings from the NestJS ConfigService
+ * and returns a validated service config.
+ *
+ * Resolves the API URL via environment variables following the naming convention
+ * `ZOHO_SIGN_API_URL` (service-specific) or `ZOHO_API_URL` (shared fallback).
+ *
+ * @param configService - NestJS config service populated with Zoho environment variables
+ * @returns Validated Zoho Sign service configuration
+ * @throws {Error} If required config values (e.g. API URL) are missing
+ *
+ * @example
+ * ```typescript
+ * // Typically used as a NestJS factory provider:
+ * {
+ *   provide: ZohoSignServiceConfig,
+ *   inject: [ConfigService],
+ *   useFactory: zohoSignServiceConfigFactory
+ * }
+ * ```
+ */
+function zohoSignServiceConfigFactory(configService) {
+    const getFromConfigService = zohoConfigServiceReaderFunction(zoho.ZOHO_SIGN_SERVICE_NAME, configService);
+    const config = {
+        zohoSign: {
+            apiUrl: getFromConfigService(ZOHO_API_URL_CONFIG_KEY)
+        }
+    };
+    ZohoSignServiceConfig.assertValidConfig(config);
+    return config;
+}
+/**
+ * Reads Zoho Accounts (OAuth) settings scoped to the Sign service from
+ * the NestJS ConfigService and returns an accounts service config.
+ *
+ * @param configService - NestJS config service populated with Zoho OAuth environment variables
+ * @returns Zoho Accounts service config scoped to the Sign service access token
+ *
+ * @example
+ * ```typescript
+ * {
+ *   provide: ZohoAccountsServiceConfig,
+ *   inject: [ConfigService],
+ *   useFactory: zohoSignAccountServiceConfigFactory
+ * }
+ * ```
+ */
+function zohoSignAccountServiceConfigFactory(configService) {
+    return zohoAccountsServiceConfigFromConfigService({
+        configService,
+        serviceAccessTokenKey: zoho.ZOHO_SIGN_SERVICE_NAME
+    });
+}
+/**
+ * Generates NestJS {@link ModuleMetadata} that wires up the full Zoho Sign stack
+ * (config, accounts, and API service) so consuming modules only need a single import.
+ *
+ * The generated module requires the following dependencies in order to initialize properly:
+ * - {@link ZohoAccountsAccessTokenCacheService}
+ *
+ * Use the `dependencyModule` config option to import a module that exports those dependencies.
+ *
+ * The returned metadata registers {@link ZohoSignServiceConfig}, {@link ZohoSignApi},
+ * {@link ZohoAccountsServiceConfig}, and {@link ZohoAccountsApi} as providers, and
+ * exports {@link ZohoSignApi} by default. Additional imports, exports, and providers
+ * from the config are merged in.
+ *
+ * @param config - Module configuration with optional dependency module and extra metadata
+ * @returns Complete NestJS module metadata ready to pass to `@Module()`
+ *
+ * @example
+ * ```typescript
+ * const cacheService = fileZohoAccountsAccessTokenCacheService();
+ *
+ * @Module({
+ *   providers: [
+ *     {
+ *       provide: ZohoAccountsAccessTokenCacheService,
+ *       useValue: cacheService
+ *     }
+ *   ],
+ *   exports: [ZohoAccountsAccessTokenCacheService]
+ * })
+ * export class ZohoSignDependencyModule {}
+ *
+ * @Module(appZohoSignModuleMetadata({ dependencyModule: ZohoSignDependencyModule }))
+ * export class AppZohoSignModule {}
+ * ```
+ */
+function appZohoSignModuleMetadata(config$1) {
+    const { dependencyModule, imports, exports: exports$1, providers } = config$1;
+    const dependencyModuleImport = dependencyModule ? [dependencyModule] : [];
+    return {
+        imports: [config.ConfigModule, ...dependencyModuleImport, ...(imports ?? [])],
+        exports: [exports.ZohoSignApi, ...(exports$1 ?? [])],
+        providers: [
+            {
+                provide: ZohoSignServiceConfig,
+                inject: [config.ConfigService],
+                useFactory: zohoSignServiceConfigFactory
+            },
+            exports.ZohoSignApi,
+            // Accounts
+            {
+                provide: ZohoAccountsServiceConfig,
+                inject: [config.ConfigService],
+                useFactory: zohoSignAccountServiceConfigFactory
+            },
+            exports.ZohoAccountsApi,
+            ...(providers ?? [])
+        ]
+    };
+}
+
 exports.DEFAULT_FILE_ZOHO_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH = DEFAULT_FILE_ZOHO_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH;
 exports.ZOHO_API_URL_CONFIG_KEY = ZOHO_API_URL_CONFIG_KEY;
 exports.ZohoAccountsServiceConfig = ZohoAccountsServiceConfig;
+exports.ZohoCrmServiceConfig = ZohoCrmServiceConfig;
 exports.ZohoRecruitServiceConfig = ZohoRecruitServiceConfig;
+exports.ZohoSignServiceConfig = ZohoSignServiceConfig;
+exports.appZohoCrmModuleMetadata = appZohoCrmModuleMetadata;
 exports.appZohoRecruitModuleMetadata = appZohoRecruitModuleMetadata;
+exports.appZohoSignModuleMetadata = appZohoSignModuleMetadata;
 exports.assertValidZohoConfig = assertValidZohoConfig;
 exports.fileZohoAccountsAccessTokenCacheService = fileZohoAccountsAccessTokenCacheService;
 exports.logMergeZohoAccountsAccessTokenCacheServiceErrorFunction = logMergeZohoAccountsAccessTokenCacheServiceErrorFunction;
@@ -609,5 +1253,9 @@ exports.mergeZohoAccountsAccessTokenCacheServices = mergeZohoAccountsAccessToken
 exports.readZohoConfigFromConfigService = readZohoConfigFromConfigService;
 exports.zohoAccountsServiceConfigFromConfigService = zohoAccountsServiceConfigFromConfigService;
 exports.zohoConfigServiceReaderFunction = zohoConfigServiceReaderFunction;
+exports.zohoCrmAccountServiceConfigFactory = zohoCrmAccountServiceConfigFactory;
+exports.zohoCrmServiceConfigFactory = zohoCrmServiceConfigFactory;
 exports.zohoRecruitAccountServiceConfigFactory = zohoRecruitAccountServiceConfigFactory;
 exports.zohoRecruitServiceConfigFactory = zohoRecruitServiceConfigFactory;
+exports.zohoSignAccountServiceConfigFactory = zohoSignAccountServiceConfigFactory;
+exports.zohoSignServiceConfigFactory = zohoSignServiceConfigFactory;