fullname-extractor

fullname-extractor parses unstructured text and tries to identify:

• honorific
• gender
• firstName
• middleName
• lastName
• name

It is designed for noisy inputs such as chat messages, self-introductions, and short free-form text.

Install

npm install fullname-extractor

Usage

const extractFullName = require('fullname-extractor')

const result = extractFullName('my name is cool mr rohan jijaram solse')

console.log(result)

Example output:

{
  status: 'success',
  honorific: 'Mr.',
  gender: 'Male',
  firstName: 'Rohan',
  middleName: 'Jijaram',
  lastName: 'Solse',
  name: 'Rohan Jijaram Solse'
}

Behavior

• Filters filler words, slang, and known non-name tokens.
• Uses dictionary-based filtering to remove common English words.
• Falls back to contextual extraction after phrases like name is and after honorifics such as mr or dr.
• Returns a consistent failure model when no name can be found.

Development

npm test

Project Structure

.
|-- index.js
|-- src
|   |-- extractor.js
|   |-- data
|       |-- dictionaries
|       `-- signals
`-- test