next-filegen

next-filegen is a flexible Node.js package for generating filenames dynamically using various strategies.

Features

• Multiple Filename Strategies: Supports random, uuid, timestamp, date, numbered, slug, hash, and incremental.
• Customizable Output: Add prefixes, suffixes, and formats to filenames.
• Developer-Friendly: Works seamlessly in any Node.js project.

Installation

Install my-project with npm

  npm install next-filegen

Usage/Examples

import { generateFilename } from 'next-filegen'

const filename = generateFilename('document', 'pdf', 'timestamp', {
  prefix: 'letter_',
  suffix: '_signed',
  format: 'Y-m-d_H-i-s',
})

console.log(filename) // Outputs: "letter_2025-03-27_14-30-00_document_signed.pdf"

Available Strategies

Strategy	Description
random	Generates a random alphanumeric string.
uuid	Uses UUID v4 for unique filenames.
timestamp	Adds a timestamp (ISO format) to the filename.
date	Uses only the date (YYYY-MM-DD).
numbered	Appends a specific number to the filename.
slug	Converts the filename to a URL-friendly slug.
hash	Generates an MD5 hash of the filename.
incremental	Appends a timestamp to ensure uniqueness.