Add optional context parameter for scoring directives

Exposes the new API-side context field on resumeJobMatchScore() so
callers can steer the scoring engine via EMPHASIZE / DEEMPHASIZE /
CREDIT directives (max 5000 chars). Backwards-compatible — context
defaults to null and is only forwarded when provided.

Also drops the unused SharpApiJobTypeEnum import and bumps version to
1.1.0.

Author: makowskid

README.md

@@ -63,10 +63,17 @@ const fs = require('fs');
 const resumePath = './resume.pdf';
 const jobDescription = 'Senior Software Engineer position...';
 
+// Optional scoring directives (max 5000 chars). See "Context directives" below.
+const context = `
+EMPHASIZE: backend scalability
+DEEMPHASIZE: frontend frameworks
+CREDIT: AWS
+`.trim();
+
 async function calculateMatchScore() {
   try {
-    // Submit matching job
-    const statusUrl = await service.resumeJobMatchScore(resumePath, jobDescription);
+    // Submit matching job — language and context are optional
+    const statusUrl = await service.resumeJobMatchScore(resumePath, jobDescription, 'English', context);
     console.log('Job submitted. Status URL:', statusUrl);
 
     // Fetch results (polls automatically until complete)
@@ -126,6 +133,31 @@ For more examples, visit the [Product Page](https://sharpapi.com/en/catalog/ai/h
 
 ---
 
+## Context directives
+
+The optional `context` parameter lets you steer the scoring engine using a formal directive contract. The engine recognises three directive shapes, which can be mixed freely in a single string:
+
+| Directive | Effect |
+|-----------|--------|
+| `EMPHASIZE: <topic>` | Increases the matching metric weight by one step |
+| `DEEMPHASIZE: <topic>` | Decreases the matching metric weight by one step |
+| `CREDIT: <skill \| tool \| certification>` | Treats the named item as a plausible role requirement even if it is absent from the job description |
+
+Directives influence the `overall_match` score and the individual metric scores before the weighted average is computed.
+
+**Limit:** the context string may be up to **5000 characters**. Requests exceeding the limit fail with HTTP 422.
+
+Example:
+
+```text
+EMPHASIZE: backend scalability
+DEEMPHASIZE: frontend frameworks
+CREDIT: AWS
+CREDIT: Kubernetes
+```
+
+---
+
 ## API Endpoint
 
 **POST** `/hr/resume_job_match_score`

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sharpapi/sharpapi-node-resume-job-match-score",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "SharpAPI.com Node.js SDK for matching resumes to job descriptions",
   "main": "src/index.js",
   "scripts": {

src/SharpApiResumeJobMatchScoreService.js

@@ -1,4 +1,4 @@
-const { SharpApiCoreService, SharpApiJobTypeEnum } = require('@sharpapi/sharpapi-node-core');
+const { SharpApiCoreService } = require('@sharpapi/sharpapi-node-core');
 
 /**
  * Service for matching resumes to job descriptions using SharpAPI.com
@@ -10,7 +10,7 @@ class SharpApiResumeJobMatchScoreService extends SharpApiCoreService {
    * @param {string} [apiBaseUrl='https://sharpapi.com/api/v1'] - API base URL
    */
   constructor(apiKey, apiBaseUrl = 'https://sharpapi.com/api/v1') {
-    super(apiKey, apiBaseUrl, '@sharpapi/sharpapi-node-resume-job-match-score/1.0.1');
+    super(apiKey, apiBaseUrl, '@sharpapi/sharpapi-node-resume-job-match-score/1.1.0');
   }
 
   /**
@@ -20,17 +20,22 @@ class SharpApiResumeJobMatchScoreService extends SharpApiCoreService {
    * @param {string} resumeFilePath - The path to the resume file (PDF/DOC/DOCX/TXT/RTF).
    * @param {string} jobDescription - The job description text to match against.
    * @param {string|null} language - The language of the resume and job description. Defaults to 'English'.
+   * @param {string|null} context - Optional scoring directives (EMPHASIZE: / DEEMPHASIZE: / CREDIT:).
+   *                                Max 5000 characters. See README for the directive contract.
    * @returns {Promise<string>} - The status URL.
    */
-  async resumeJobMatchScore(resumeFilePath, jobDescription, language = null) {
-    const data = { 
+  async resumeJobMatchScore(resumeFilePath, jobDescription, language = null, context = null) {
+    const data = {
       job_description: jobDescription,
-      content: jobDescription 
+      content: jobDescription
     };
     if (language) {
       data.language = language;
     }
-    const response = await this.makeRequest('POST', SharpApiJobTypeEnum.HR_RESUME_JOB_MATCH_SCORE.url, data, resumeFilePath);
+    if (context) {
+      data.context = context;
+    }
+    const response = await this.makeRequest('POST', '/hr/resume_job_match_score', data, resumeFilePath);
     return this.parseStatusUrl(response);
   }
 }