get-reading-time 1.0.5 → 1.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Md Nur Ahmad
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,4 @@
+
 # Text Analysis Tool
 
 A simple text analysis tool that provides insights into text such as reading time, word count, sentiment, readability score, link count, and SEO-friendly keywords.
@@ -12,6 +13,8 @@ A simple text analysis tool that provides insights into text such as reading tim
 - **Readability Score**: Calculates the Flesch Reading Ease score to evaluate the text's readability.
 - **Sentiment Analysis**: Analyzes the sentiment of the text (Positive, Negative, or Neutral).
 - **SEO-friendly Keywords**: Extracts the top 5 SEO-friendly keywords or key phrases (bi-grams and tri-grams) from the text.
+- **aiTexGen**: Allows users to generate content based on a search prompt using the Cohere AI API, with a specified word count.
+- **Automatic Punctuation and Capitalization**: Automatically adds proper punctuation and capitalizes the beginning of sentences in a provided text.
 
 ## Installation
 
@@ -35,7 +38,7 @@ Here’s how you can use the analyzeText function to analyze a piece of text:
 import { analyzeText } from "get-reading-time/dist/index.js";
 ```
 
-// Example input text
+### Example Code
 
 ```javascript
 const text = `This is an example of text. It contains words, sentences, and links like there are https://linkedin.com/in/06nurahmed https://github.com/nurahmed123`;
@@ -81,10 +84,95 @@ try {
 }
 ```
 
+### aiTexGen: Generate your content
+This new feature allows users to generate content using Cohere AI. You provide your Cohere API key, a search prompt, and a word count, and it will return the generated content.
+
+### Usage
+To use the **aiTexGen** feature, follow these steps:
+```bash
+import { aiTexGen } from "get-reading-time/dist/index.js";
+```
+
+### Example Code
+- Create your [Api key](https://dashboard.cohere.com/api-keys) From here.
+```javascript
+// Replace this with your Cohere API key
+const apiKey = '<api-key>';
+const generator = new aiTexGen(apiKey);
+
+async function testGenerateContent() {
+    try {
+        // Define a topic and word count for testing
+        const topic = 'arduino';
+        const wordCount = 100;
+
+        // Call the generateContent method
+        const result = await generator.generateContent(topic, wordCount);
+
+        // Output the result in JSON format
+        console.log('Generated Content (JSON Format):');
+        console.log(JSON.stringify(result, null, 2)); // Pretty print the JSON output
+
+    } catch (error) {
+        console.error('Error during content generation:', error);
+    }
+}
+// Run the test
+testGenerateContent();
+```
+### Example Output
+```json
+{
+  "topic": "arduino",
+  "content": "Arduino is an open-source electronics platform based on easy-to-use hardware and software. It's designed to make interactive projects accessible to everyone, from artists and designers to hobbyists and engineers. \n\nAt the heart of the Arduino platform is the Arduino board, a simple microcontroller board that can read inputs and turn them into outputs, such as turning on an LED light or activating a motor. \n\nWhat makes Arduino unique is its user-friendly approach, with a simplified programming language and easy-to-use hardware, making it a popular choice for beginners and professionals alike. With its versatility and robust community support, Arduino has become a go-to platform for creating interactive, sensor-based projects and prototypes."
+}
+```
+
+### Automatic Punctuation and Capitalization
+
+You can now pass an article to the `analyzeText` function, and it will automatically fix punctuation and capitalize the first letter of sentences. This feature helps to improve the readability of raw text.
+
+#### Example Code
+Import the package and follow the steps: 
+```javascript
+import { getPunch } from 'get-reading-time/dist/index.js';
+```
+
+```javascript
+// Example to test with a string
+const content = "once a lion a fox and a wolf went hunting they ultimately spotted a stag and killed him for their food while sharing the hunt quarter me this stag roared the lion and other animals skinned and cut the spoil into four equal parts";
+async function GetPunch() {
+    try {
+        // Call the getPunch function with content
+        const result = await getPunch(content);
+
+        // Check the result and log it as a formatted JSON response
+        if (result.status_code === 200) {
+            console.log(JSON.stringify(result, null, 2));
+        } else {
+            console.error("Error:", JSON.stringify(result, null, 2));
+        }
+    } catch (error) {
+        // Handle unexpected errors
+        console.error("Unexpected Error:", error);
+    }
+}
+// Run the test
+GetPunch();
+```
+
+### Example Output
+```json
+{
+  "content": "Once a Lion, a Fox and a Wolf went hunting, they ultimately found a stag and killed him for their food while sharing the hunt quarter me. This stag roared the Lion and other animals skinned and cut the spoil into four equal parts.",
+  "status_code": 200
+}
+```
 ## Parameters
 
 - text: The text to be analyzed (required).
 - wordsPerMinute: The reading speed in words per minute (optional, default is 200 words per minute).
+- **apiKey**: Your Cohere API key to use this feature (required).
 
 ## Functions
 
@@ -100,6 +188,8 @@ Analyzes the provided text and returns an object containing:
 - readabilityScore: Flesch Reading Ease score (higher is easier to read).
 - sentiment: Sentiment of the text (Positive, Negative, or Neutral).
 - keywords: Top 5 SEO-friendly keywords or key phrases.
+### Generate Content(topic: string, wordCount: number)
+Generates content based on the given topic and word count using the Cohere AI API and returns the generated content.
 
 ### Helper Functions
 
@@ -113,6 +203,8 @@ Analyzes the provided text and returns an object containing:
 - **extractKeywords(text: string)**: Extracts the top 5 SEO-friendly keywords or key phrases.
 - **extractNGrams(words: string[])**: Extracts bi-grams and tri-grams from the list of words.
 - **isStopWord(word: string, stopWords: Set<string>)**: Checks if a word is a stop word to exclude from keyword extraction.
+- **generateContent(words: string[])**: Genarate text based on the query and word limit.
+- **autoPunctuateAndCapitalize(text: string)**: Adds punctuation and capitalization to the content.
 
 ## Contributing
 
@@ -120,7 +212,8 @@ Feel free to fork the repository, make your changes, and submit a pull request.
 
 ## License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+This project is licensed under the MIT License - see the [LICENSE](https://github.com/nurahmed123/get-reading-time/blob/main/LICENSE) file for details.
+[![npm version](https://badge.fury.io/js/get-reading-time.svg)](https://www.npmjs.com/get-reading-time)
 
 ## Contact
 

package/dist/index.d.mts

@@ -14,4 +14,26 @@ interface TextAnalysisResult {
 }
 declare function analyzeText(text: string, wordsPerMinute?: number): TextAnalysisResult;
 
-export { analyzeText };
+type ApiResponse = {
+    formatted_text?: string;
+    error?: string;
+    status_code: number;
+    content?: string;
+};
+declare function getPunch(next: string): Promise<ApiResponse>;
+
+declare class AiTexGen {
+    private cohereClient;
+    constructor(apiKey: string);
+    private validateInputs;
+    generateContent(topic: string, wordCount?: number): Promise<{
+        topic: string;
+        content: string;
+    }>;
+    private processContent;
+    private extractTextFromObject;
+    private createErrorResponse;
+    private formatErrorDetails;
+}
+
+export { AiTexGen as aiTexGen, analyzeText, getPunch };

package/dist/index.d.ts

@@ -14,4 +14,26 @@ interface TextAnalysisResult {
 }
 declare function analyzeText(text: string, wordsPerMinute?: number): TextAnalysisResult;
 
-export { analyzeText };
+type ApiResponse = {
+    formatted_text?: string;
+    error?: string;
+    status_code: number;
+    content?: string;
+};
+declare function getPunch(next: string): Promise<ApiResponse>;
+
+declare class AiTexGen {
+    private cohereClient;
+    constructor(apiKey: string);
+    private validateInputs;
+    generateContent(topic: string, wordCount?: number): Promise<{
+        topic: string;
+        content: string;
+    }>;
+    private processContent;
+    private extractTextFromObject;
+    private createErrorResponse;
+    private formatErrorDetails;
+}
+
+export { AiTexGen as aiTexGen, analyzeText, getPunch };

package/dist/index.js

@@ -26,13 +26,37 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
 
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  analyzeText: () => analyzeText
+  aiTexGen: () => AiTexGen,
+  analyzeText: () => analyzeText,
+  getPunch: () => getPunch
 });
 module.exports = __toCommonJS(index_exports);
+
+// src/utils/analyzeText.ts
 var import_sentiment = __toESM(require("sentiment"));
 var DEFAULT_READING_SPEED = 200;
 function analyzeText(text, wordsPerMinute = DEFAULT_READING_SPEED) {
@@ -160,7 +184,124 @@ function extractNGrams(words) {
 function isStopWord(word, stopWords) {
   return stopWords.has(word);
 }
+
+// src/utils/getPunch.ts
+var import_axios = __toESM(require("axios"));
+var API_URL = "https://e4fc-35-185-85-107.ngrok-free.app/get-reading-time";
+var SECRET_CODE = "amrseccode";
+function getPunch(next) {
+  return __async(this, null, function* () {
+    var _a;
+    try {
+      const response = yield import_axios.default.post(API_URL, {
+        secret_code: SECRET_CODE,
+        content: next
+      });
+      return {
+        content: response.data.formatted_text || "No content returned",
+        status_code: 200
+      };
+    } catch (error) {
+      return {
+        error: ((_a = error.response) == null ? void 0 : _a.data) || "Failed to get response from the server.",
+        status_code: 500
+      };
+    }
+  });
+}
+
+// src/utils/aiTexGen.ts
+var import_cohere_ai = require("cohere-ai");
+var AiTexGen = class {
+  constructor(apiKey) {
+    if (!apiKey || typeof apiKey !== "string") {
+      throw this.createErrorResponse("API_KEY_MISSING", "A valid API key must be provided.", 400);
+    }
+    this.cohereClient = new import_cohere_ai.CohereClientV2({ token: apiKey });
+  }
+  // Validate user input (topic and word count)
+  validateInputs(topic, wordCount) {
+    if (typeof topic !== "string" || topic.trim().length === 0) {
+      throw this.createErrorResponse("INVALID_TOPIC", "Topic must be a non-empty string.", 400);
+    }
+    if (typeof wordCount !== "number" || wordCount <= 0) {
+      console.warn("Invalid word count provided. Defaulting to 100 words.");
+      wordCount = 100;
+    }
+  }
+  // Generate content using Cohere's API
+  generateContent(topic, wordCount = 100) {
+    return __async(this, null, function* () {
+      var _a;
+      try {
+        this.validateInputs(topic, wordCount);
+        const prompt = `Write a detailed article about ${topic}, aiming for maximum ${wordCount} words.`;
+        const response = yield this.cohereClient.chat({
+          model: "command-r-plus",
+          // Specify the model you want to use
+          messages: [
+            {
+              role: "user",
+              content: prompt
+              // Use the prompt with the topic and word count
+            }
+          ]
+        });
+        const content = this.processContent((_a = response.message) == null ? void 0 : _a.content);
+        return {
+          topic,
+          content
+        };
+      } catch (error) {
+        console.error("Error generating content from Cohere API:", error);
+        throw this.createErrorResponse("API_ERROR", "Failed to generate content from Cohere API.", 500, this.formatErrorDetails(error));
+      }
+    });
+  }
+  // Helper method to process the content and format it properly
+  processContent(content) {
+    if (!content || content.length === 0) {
+      return "No content generated or content is empty.";
+    }
+    return content.map((item) => {
+      if (typeof item === "string") {
+        return item.trim();
+      } else if (typeof item === "object") {
+        return this.extractTextFromObject(item);
+      }
+      return "";
+    }).join(" ").trim();
+  }
+  // Helper method to safely extract text from an object, if needed
+  extractTextFromObject(obj) {
+    if (obj && obj.text) {
+      return obj.text.trim();
+    }
+    return "";
+  }
+  // Helper method to create an error response with a status code
+  createErrorResponse(code, message, statusCode, details) {
+    return {
+      error: {
+        code,
+        message,
+        statusCode,
+        details: details || ""
+      }
+    };
+  }
+  // Helper method to format error details (narrowing down the 'unknown' type)
+  formatErrorDetails(error) {
+    if (error instanceof Error) {
+      return error.message;
+    } else {
+      return "An unknown error occurred.";
+    }
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  analyzeText
+  aiTexGen,
+  analyzeText,
+  getPunch
 });

package/dist/index.mjs

@@ -1,4 +1,25 @@
-// src/index.ts
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+
+// src/utils/analyzeText.ts
 import Sentiment from "sentiment";
 var DEFAULT_READING_SPEED = 200;
 function analyzeText(text, wordsPerMinute = DEFAULT_READING_SPEED) {
@@ -126,6 +147,123 @@ function extractNGrams(words) {
 function isStopWord(word, stopWords) {
   return stopWords.has(word);
 }
+
+// src/utils/getPunch.ts
+import axios from "axios";
+var API_URL = "https://e4fc-35-185-85-107.ngrok-free.app/get-reading-time";
+var SECRET_CODE = "amrseccode";
+function getPunch(next) {
+  return __async(this, null, function* () {
+    var _a;
+    try {
+      const response = yield axios.post(API_URL, {
+        secret_code: SECRET_CODE,
+        content: next
+      });
+      return {
+        content: response.data.formatted_text || "No content returned",
+        status_code: 200
+      };
+    } catch (error) {
+      return {
+        error: ((_a = error.response) == null ? void 0 : _a.data) || "Failed to get response from the server.",
+        status_code: 500
+      };
+    }
+  });
+}
+
+// src/utils/aiTexGen.ts
+import { CohereClientV2 } from "cohere-ai";
+var AiTexGen = class {
+  constructor(apiKey) {
+    if (!apiKey || typeof apiKey !== "string") {
+      throw this.createErrorResponse("API_KEY_MISSING", "A valid API key must be provided.", 400);
+    }
+    this.cohereClient = new CohereClientV2({ token: apiKey });
+  }
+  // Validate user input (topic and word count)
+  validateInputs(topic, wordCount) {
+    if (typeof topic !== "string" || topic.trim().length === 0) {
+      throw this.createErrorResponse("INVALID_TOPIC", "Topic must be a non-empty string.", 400);
+    }
+    if (typeof wordCount !== "number" || wordCount <= 0) {
+      console.warn("Invalid word count provided. Defaulting to 100 words.");
+      wordCount = 100;
+    }
+  }
+  // Generate content using Cohere's API
+  generateContent(topic, wordCount = 100) {
+    return __async(this, null, function* () {
+      var _a;
+      try {
+        this.validateInputs(topic, wordCount);
+        const prompt = `Write a detailed article about ${topic}, aiming for maximum ${wordCount} words.`;
+        const response = yield this.cohereClient.chat({
+          model: "command-r-plus",
+          // Specify the model you want to use
+          messages: [
+            {
+              role: "user",
+              content: prompt
+              // Use the prompt with the topic and word count
+            }
+          ]
+        });
+        const content = this.processContent((_a = response.message) == null ? void 0 : _a.content);
+        return {
+          topic,
+          content
+        };
+      } catch (error) {
+        console.error("Error generating content from Cohere API:", error);
+        throw this.createErrorResponse("API_ERROR", "Failed to generate content from Cohere API.", 500, this.formatErrorDetails(error));
+      }
+    });
+  }
+  // Helper method to process the content and format it properly
+  processContent(content) {
+    if (!content || content.length === 0) {
+      return "No content generated or content is empty.";
+    }
+    return content.map((item) => {
+      if (typeof item === "string") {
+        return item.trim();
+      } else if (typeof item === "object") {
+        return this.extractTextFromObject(item);
+      }
+      return "";
+    }).join(" ").trim();
+  }
+  // Helper method to safely extract text from an object, if needed
+  extractTextFromObject(obj) {
+    if (obj && obj.text) {
+      return obj.text.trim();
+    }
+    return "";
+  }
+  // Helper method to create an error response with a status code
+  createErrorResponse(code, message, statusCode, details) {
+    return {
+      error: {
+        code,
+        message,
+        statusCode,
+        details: details || ""
+      }
+    };
+  }
+  // Helper method to format error details (narrowing down the 'unknown' type)
+  formatErrorDetails(error) {
+    if (error instanceof Error) {
+      return error.message;
+    } else {
+      return "An unknown error occurred.";
+    }
+  }
+};
 export {
-  analyzeText
+  AiTexGen as aiTexGen,
+  analyzeText,
+  getPunch
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "get-reading-time",
-  "version": "1.0.5",
+  "version": "1.2.1",
   "main": "/dist/index.js",
   "module": "/dist/index.mjs",
   "types": "/dist/index.d.ts",
@@ -12,7 +12,11 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/nurahmed123/get-reading-time.git"
+    "url": "git+https://github.com/nurahmed123/get-reading-time.git",
+    "license": "https://github.com/nurahmed123/get-reading-time/blob/main/LICENSE"
+  },
+  "publishConfig": {
+    "registry": "https://www.npmjs.com/package/get-reading-time"
   },
   "keywords": [
     "Reading",
@@ -136,11 +140,14 @@
   "homepage": "https://github.com/nurahmed123/get-reading-time#readme",
   "description": "",
   "devDependencies": {
+    "@types/axios": "^0.9.36",
     "@types/node": "^22.10.2",
     "@types/sentiment": "^5.0.4",
     "typescript": "^5.7.2"
   },
   "dependencies": {
+    "axios": "^1.7.9",
+    "cohere-ai": "^7.15.0",
     "sentiment": "^5.0.2",
     "tsup": "^8.3.5"
   }