@amirdaraee/namewise 0.5.3 → 0.5.4

package/src/utils/ai-prompts.ts

@@ -1,76 +0,0 @@
-import { FileInfo } from '../types/index.js';
-import { getNamingInstructions, NamingConvention } from './naming-conventions.js';
-import { getTemplateInstructions, FileCategory } from './file-templates.js';
-
-export interface PromptContext {
-  content: string;
-  originalName: string;
-  namingConvention: NamingConvention;
-  category: FileCategory;
-  fileInfo?: FileInfo;
-}
-
-/**
- * Builds a standardized prompt for AI filename generation
- * This prompt is used across all AI providers (Claude, OpenAI, LMStudio, Ollama)
- */
-export function buildFileNamePrompt(context: PromptContext): string {
-  const { content, originalName, namingConvention, category, fileInfo } = context;
-  
-  const namingInstructions = getNamingInstructions(namingConvention);
-  const templateInstructions = getTemplateInstructions(category);
-  
-  // Build comprehensive context from all metadata
-  let metadataContext = '';
-  if (fileInfo) {
-    metadataContext += `File Information:
-- Original filename: ${originalName}
-- File size: ${Math.round(fileInfo.size / 1024)}KB
-- Created: ${fileInfo.createdAt.toLocaleDateString()}
-- Modified: ${fileInfo.modifiedAt.toLocaleDateString()}
-- Parent folder: ${fileInfo.parentFolder}
-- Folder path: ${fileInfo.folderPath.join(' > ')}`;
-
-    if (fileInfo.documentMetadata) {
-      const meta = fileInfo.documentMetadata;
-      metadataContext += `
-Document Properties:`;
-      if (meta.title) metadataContext += `\n- Title: ${meta.title}`;
-      if (meta.author) metadataContext += `\n- Author: ${meta.author}`;
-      if (meta.creator) metadataContext += `\n- Creator: ${meta.creator}`;
-      if (meta.subject) metadataContext += `\n- Subject: ${meta.subject}`;
-      if (meta.keywords?.length) metadataContext += `\n- Keywords: ${meta.keywords.join(', ')}`;
-      if (meta.creationDate) metadataContext += `\n- Created: ${meta.creationDate.toLocaleDateString()}`;
-      if (meta.modificationDate) metadataContext += `\n- Modified: ${meta.modificationDate.toLocaleDateString()}`;
-      if (meta.pages) metadataContext += `\n- Pages: ${meta.pages}`;
-      if (meta.wordCount) metadataContext += `\n- Word count: ${meta.wordCount}`;
-    }
-  }
-
-  return `Based on the following document information, generate a descriptive filename that captures the main topic/purpose of the document. The filename should be:
-- Descriptive and meaningful
-- Professional and clean
-- Between 3-10 words
-- ${namingInstructions}
-- ${templateInstructions}
-- Do not include file extension
-- If the document is specifically for/about a person (based on content), include their name at the beginning
-- Include dates only if they are essential to the document's identity (e.g., contracts, certificates)
-- Ignore irrelevant folder names that don't describe the document content
-- Only use letters, numbers, and appropriate separators for the naming convention
-- Focus on the document's actual content and purpose, not just metadata
-
-${metadataContext}
-
-Document content (first 2000 characters):
-${content.substring(0, 2000)}
-
-Important: If this document is specifically for or about a particular person mentioned in the content, start the filename with their name. Otherwise, focus on the document's main purpose and content.
-
-Respond with only the filename using the specified naming convention, no explanation.`;
-}
-
-/**
- * System prompt for AI models that need a separate system message
- */
-export const AI_SYSTEM_PROMPT = 'You are a helpful assistant that generates descriptive filenames based on document content. Always respond with just the filename, no explanation or additional text.';

package/src/utils/file-templates.ts

@@ -1,275 +0,0 @@
-import { NamingConvention, FileInfo } from '../types/index.js';
-import { applyNamingConvention } from './naming-conventions.js';
-
-export type FileCategory = 'document' | 'movie' | 'music' | 'series' | 'photo' | 'book' | 'general' | 'auto';
-
-export interface TemplateOptions {
-  personalName?: string;
-  dateFormat?: 'YYYY-MM-DD' | 'YYYY' | 'YYYYMMDD' | 'none';
-  category?: FileCategory;
-}
-
-export interface FileTemplate {
-  category: FileCategory;
-  pattern: string; // e.g., "{content}-{personalName}-{date}"
-  description: string;
-  examples: string[];
-}
-
-export const FILE_TEMPLATES: Record<Exclude<FileCategory, 'auto'>, FileTemplate> = {
-  document: {
-    category: 'document',
-    pattern: '{content}-{personalName}-{date}',
-    description: 'Personal documents with name and date',
-    examples: [
-      'driving-license-amirhossein-20250213.pdf',
-      'dennemeyer-working-contract-amirhossein-20240314.pdf',
-      'university-diploma-sarah-20220615.pdf'
-    ]
-  },
-  movie: {
-    category: 'movie',
-    pattern: '{content}-{year}',
-    description: 'Movies with release year',
-    examples: [
-      'the-dark-knight-2008.mkv',
-      'inception-2010.mp4',
-      'pulp-fiction-1994.avi'
-    ]
-  },
-  music: {
-    category: 'music',
-    pattern: '{artist}-{content}',
-    description: 'Music files with artist name',
-    examples: [
-      'the-beatles-hey-jude.mp3',
-      'queen-bohemian-rhapsody.flac',
-      'pink-floyd-wish-you-were-here.wav'
-    ]
-  },
-  series: {
-    category: 'series',
-    pattern: '{content}-s{season}e{episode}',
-    description: 'TV series with season and episode',
-    examples: [
-      'breaking-bad-s01e01.mkv',
-      'game-of-thrones-s04e09.mp4',
-      'the-office-s02e01.avi'
-    ]
-  },
-  photo: {
-    category: 'photo',
-    pattern: '{content}-{personalName}-{date}',
-    description: 'Photos with personal name and date',
-    examples: [
-      'vacation-paris-john-20240715.jpg',
-      'wedding-ceremony-maria-20231009.png',
-      'birthday-party-alex-20240320.heic'
-    ]
-  },
-  book: {
-    category: 'book',
-    pattern: '{author}-{content}',
-    description: 'Books with author name',
-    examples: [
-      'george-orwell-1984.pdf',
-      'j-k-rowling-harry-potter-philosophers-stone.epub',
-      'stephen-king-the-shining.mobi'
-    ]
-  },
-  general: {
-    category: 'general',
-    pattern: '{content}',
-    description: 'General files without special formatting',
-    examples: [
-      'meeting-notes-q4-2024.txt',
-      'project-requirements.docx',
-      'financial-report.xlsx'
-    ]
-  }
-};
-
-export function categorizeFile(filePath: string, content?: string, fileInfo?: FileInfo): FileCategory {
-  const extension = getFileExtension(filePath).toLowerCase();
-  const fileName = getFileName(filePath).toLowerCase();
-  const contentLower = content?.toLowerCase() || '';
-
-  // Use metadata for enhanced categorization
-  let metadataHints: string[] = [];
-  if (fileInfo?.documentMetadata) {
-    const meta = fileInfo.documentMetadata;
-    if (meta.title) metadataHints.push(meta.title.toLowerCase());
-    if (meta.author) metadataHints.push(meta.author.toLowerCase());
-    if (meta.creator) metadataHints.push(meta.creator.toLowerCase());
-    if (meta.subject) metadataHints.push(meta.subject.toLowerCase());
-    if (meta.keywords) metadataHints.push(...meta.keywords.map(k => k.toLowerCase()));
-  }
-
-  // Use folder context for better categorization
-  let folderHints: string[] = [];
-  if (fileInfo?.folderPath) {
-    folderHints = fileInfo.folderPath.map(f => f.toLowerCase());
-  }
-  if (fileInfo?.parentFolder) {
-    folderHints.push(fileInfo.parentFolder.toLowerCase());
-  }
-
-  const allHints = [...metadataHints, ...folderHints, contentLower, fileName].join(' ');
-
-  // Document types
-  const documentExtensions = ['.pdf', '.docx', '.doc', '.txt', '.rtf'];
-  const documentKeywords = ['contract', 'agreement', 'license', 'certificate', 'diploma', 'invoice', 'receipt', 'report', 'application', 'form', 'resume', 'cv', 'letter'];
-  
-  // Media types
-  const movieExtensions = ['.mp4', '.mkv', '.avi', '.mov', '.wmv', '.flv', '.webm'];
-  const musicExtensions = ['.mp3', '.flac', '.wav', '.aac', '.ogg', '.m4a'];
-  const photoExtensions = ['.jpg', '.jpeg', '.png', '.gif', '.bmp', '.tiff', '.heic', '.webp'];
-  const bookExtensions = ['.epub', '.mobi', '.azw', '.azw3'];
-  
-  // Enhanced series detection
-  const seriesKeywords = ['s01', 's02', 's03', 's04', 's05', 'season', 'episode', 'e01', 'e02', 'e03', 'series', 'show', 'tv'];
-  
-  // Enhanced movie keywords
-  const movieKeywords = ['movie', 'film', 'cinema', '1080p', '720p', '4k', 'bluray', 'dvdrip', 'webrip'];
-  
-  // Book keywords
-  const bookKeywords = ['chapter', 'author', 'book', 'novel', 'ebook', 'isbn', 'publisher', 'edition'];
-  
-  // Music keywords  
-  const musicKeywords = ['album', 'track', 'artist', 'band', 'singer', 'song', 'music'];
-  
-  // Photo keywords
-  const photoKeywords = ['photo', 'image', 'picture', 'vacation', 'wedding', 'birthday', 'selfie', 'portrait'];
-  
-  // Folder-based hints
-  const folderMovieHints = ['movies', 'films', 'cinema', 'video'];
-  const folderSeriesHints = ['series', 'shows', 'tv', 'television'];
-  const folderMusicHints = ['music', 'audio', 'songs', 'albums'];
-  const folderPhotoHints = ['photos', 'images', 'pictures', 'gallery'];
-  const folderBookHints = ['books', 'ebooks', 'library', 'reading'];
-  const folderDocumentHints = ['documents', 'docs', 'papers', 'files'];
-
-  // Check folder context first for strong hints
-  if (folderHints.some(hint => folderSeriesHints.includes(hint))) return 'series';
-  if (folderHints.some(hint => folderMovieHints.includes(hint))) return 'movie';
-  if (folderHints.some(hint => folderMusicHints.includes(hint))) return 'music';
-  if (folderHints.some(hint => folderPhotoHints.includes(hint))) return 'photo';
-  if (folderHints.some(hint => folderBookHints.includes(hint))) return 'book';
-  if (folderHints.some(hint => folderDocumentHints.includes(hint))) return 'document';
-
-  // Check for series first (before movies)
-  if (movieExtensions.includes(extension) && (
-    seriesKeywords.some(keyword => allHints.includes(keyword))
-  )) {
-    return 'series';
-  }
-
-  // Check by extension with enhanced keyword matching
-  if (documentExtensions.includes(extension)) {
-    // Check if it's a book
-    if (bookExtensions.includes(extension) || bookKeywords.some(keyword => allHints.includes(keyword))) {
-      return 'book';
-    }
-    // Check if it's likely a personal document
-    if (documentKeywords.some(keyword => allHints.includes(keyword))) {
-      return 'document';
-    }
-    return 'document'; // Default for document extensions
-  }
-
-  // Enhanced media type detection
-  if (movieExtensions.includes(extension)) {
-    if (movieKeywords.some(keyword => allHints.includes(keyword))) {
-      return 'movie';
-    }
-    return 'movie'; // Default for movie extensions
-  }
-  
-  if (musicExtensions.includes(extension)) {
-    if (musicKeywords.some(keyword => allHints.includes(keyword))) {
-      return 'music';
-    }
-    return 'music';
-  }
-  
-  if (photoExtensions.includes(extension)) {
-    if (photoKeywords.some(keyword => allHints.includes(keyword))) {
-      return 'photo';
-    }
-    return 'photo';
-  }
-  
-  if (bookExtensions.includes(extension)) return 'book';
-
-  return 'general';
-}
-
-export function applyTemplate(
-  aiGeneratedName: string,
-  category: FileCategory,
-  templateOptions: TemplateOptions,
-  namingConvention: NamingConvention
-): string {
-  if (category === 'auto') {
-    throw new Error('Cannot apply template for "auto" category. Category should be resolved before calling applyTemplate.');
-  }
-  const template = FILE_TEMPLATES[category as Exclude<FileCategory, 'auto'>];
-  let result = template.pattern;
-
-  // Replace template variables
-  result = result.replace('{content}', aiGeneratedName);
-
-  if (templateOptions.personalName) {
-    result = result.replace('{personalName}', templateOptions.personalName);
-  }
-
-  if (templateOptions.dateFormat && templateOptions.dateFormat !== 'none') {
-    const date = formatDate(new Date(), templateOptions.dateFormat);
-    result = result.replace('{date}', date);
-  }
-
-  // Clean up any remaining unreplaced variables
-  result = result.replace(/\{[^}]+\}/g, '');
-  
-  // Clean up multiple hyphens or other separators
-  result = result.replace(/-+/g, '-').replace(/^-|-$/g, '');
-
-  // Apply naming convention
-  return applyNamingConvention(result, namingConvention);
-}
-
-function formatDate(date: Date, format: 'YYYY-MM-DD' | 'YYYY' | 'YYYYMMDD'): string {
-  const year = date.getFullYear();
-  const month = String(date.getMonth() + 1).padStart(2, '0');
-  const day = String(date.getDate()).padStart(2, '0');
-
-  switch (format) {
-    case 'YYYY-MM-DD':
-      return `${year}-${month}-${day}`;
-    case 'YYYY':
-      return `${year}`;
-    case 'YYYYMMDD':
-      return `${year}${month}${day}`;
-    default:
-      return `${year}${month}${day}`;
-  }
-}
-
-function getFileExtension(filePath: string): string {
-  const parts = filePath.split('.');
-  return parts.length > 1 ? '.' + parts[parts.length - 1] : '';
-}
-
-function getFileName(filePath: string): string {
-  const pathParts = filePath.split(/[/\\]/);
-  const fileName = pathParts[pathParts.length - 1];
-  return fileName.replace(/\.[^.]*$/, ''); // Remove extension
-}
-
-export function getTemplateInstructions(category: FileCategory): string {
-  if (category === 'auto') {
-    return 'Generate appropriate filename based on detected file type and content.';
-  }
-  const template = FILE_TEMPLATES[category as Exclude<FileCategory, 'auto'>];
-  return `Generate filename for ${category} type files. ${template.description}. Examples: ${template.examples.join(', ')}`;
-}

package/src/utils/naming-conventions.ts

@@ -1,67 +0,0 @@
-export type NamingConvention = 'kebab-case' | 'snake_case' | 'camelCase' | 'PascalCase' | 'lowercase' | 'UPPERCASE';
-
-export function applyNamingConvention(text: string, convention: NamingConvention): string {
-  // First, normalize the text by removing special characters and extra spaces
-  const normalized = text
-    .replace(/[^\w\s-]/g, '') // Remove special characters except hyphens
-    .replace(/\s+/g, ' ')      // Normalize spaces
-    .trim();
-
-  switch (convention) {
-    case 'kebab-case':
-      return normalized
-        .toLowerCase()
-        .replace(/\s+/g, '-')
-        .replace(/[_]/g, '-');
-
-    case 'snake_case':
-      return normalized
-        .toLowerCase()
-        .replace(/\s+/g, '_')
-        .replace(/[-]/g, '_');
-
-    case 'camelCase':
-      return normalized
-        .split(/[\s\-_]+/)
-        .map((word, index) => 
-          index === 0 
-            ? word.toLowerCase() 
-            : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()
-        )
-        .join('');
-
-    case 'PascalCase':
-      return normalized
-        .split(/[\s\-_]+/)
-        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
-        .join('');
-
-    case 'lowercase':
-      return normalized
-        .toLowerCase()
-        .replace(/\s+/g, '')
-        .replace(/[-_]/g, '');
-
-    case 'UPPERCASE':
-      return normalized
-        .toUpperCase()
-        .replace(/\s+/g, '')
-        .replace(/[-_]/g, '');
-
-    default:
-      return normalized.replace(/\s+/g, '-').toLowerCase(); // Default to kebab-case
-  }
-}
-
-export function getNamingInstructions(convention: NamingConvention): string {
-  const instructions = {
-    'kebab-case': 'Use lowercase with hyphens between words (e.g., "meeting-notes-2024")',
-    'snake_case': 'Use lowercase with underscores between words (e.g., "meeting_notes_2024")', 
-    'camelCase': 'Use camelCase format starting with lowercase (e.g., "meetingNotes2024")',
-    'PascalCase': 'Use PascalCase format starting with uppercase (e.g., "MeetingNotes2024")',
-    'lowercase': 'Use single lowercase word with no separators (e.g., "meetingnotes2024")',
-    'UPPERCASE': 'Use single uppercase word with no separators (e.g., "MEETINGNOTES2024")'
-  };
-
-  return instructions[convention];
-}

package/src/utils/pdf-to-image.ts

@@ -1,137 +0,0 @@
-import { pdfToPng } from 'pdf-to-png-converter';
-import { createCanvas, loadImage, DOMMatrix } from 'canvas';
-import { createRequire } from 'module';
-
-// Polyfill DOMMatrix for Node.js environments (required by pdf-to-png-converter)
-if (typeof global !== 'undefined' && !global.DOMMatrix) {
-  global.DOMMatrix = DOMMatrix as any;
-}
-
-// Polyfill process.getBuiltinModule for Node.js < 22.3.0
-if (typeof process !== 'undefined' && !process.getBuiltinModule) {
-  const require = createRequire(import.meta.url);
-  (process as any).getBuiltinModule = (id: string) => {
-    try {
-      return require(id);
-    } catch (error) {
-      return null;
-    }
-  };
-}
-
-export interface PDFToImageOptions {
-  scale?: number;
-  format?: 'png' | 'jpeg';
-  firstPageOnly?: boolean;
-}
-
-export class PDFToImageConverter {
-  // Claude's maximum image size is 5MB
-  private static readonly MAX_IMAGE_SIZE_BYTES = 5 * 1024 * 1024;
-
-  static async convertFirstPageToBase64(
-    pdfBuffer: Buffer,
-    options: PDFToImageOptions = {}
-  ): Promise<string> {
-    const {
-      scale = 2.0, // Higher scale for better quality (1-3 recommended)
-      format = 'png'
-    } = options;
-
-    try {
-      // Convert PDF to PNG using pdf-to-png-converter
-      // This package handles all the canvas/image compatibility issues
-      const pngPages = await pdfToPng(pdfBuffer as any, {
-        disableFontFace: false,
-        useSystemFonts: false,
-        pagesToProcess: [1], // Only convert first page
-        verbosityLevel: 0,
-        viewportScale: scale
-      });
-
-      if (!pngPages || pngPages.length === 0) {
-        throw new Error('No pages could be converted from PDF');
-      }
-
-      // Get the first page
-      const firstPage = pngPages[0];
-
-      if (!firstPage || !firstPage.content) {
-        throw new Error('First page conversion failed');
-      }
-
-      // Load the PNG image for optimization
-      const img = await loadImage(firstPage.content);
-
-      // Always use JPEG for better compression and size control
-      // Try different quality levels to fit under the size limit
-      const qualities = [0.85, 0.7, 0.6, 0.5, 0.4, 0.3];
-
-      for (const quality of qualities) {
-        const canvas = createCanvas(img.width, img.height);
-        const ctx = canvas.getContext('2d');
-        ctx.drawImage(img, 0, 0);
-
-        const dataUrl = canvas.toDataURL('image/jpeg', quality);
-        const sizeInBytes = Math.ceil((dataUrl.length - 'data:image/jpeg;base64,'.length) * 0.75);
-
-        if (sizeInBytes <= this.MAX_IMAGE_SIZE_BYTES) {
-          return dataUrl;
-        }
-      }
-
-      // If still too large, reduce dimensions
-      const scaleFactor = 0.7;
-      const newWidth = Math.floor(img.width * scaleFactor);
-      const newHeight = Math.floor(img.height * scaleFactor);
-
-      const canvas = createCanvas(newWidth, newHeight);
-      const ctx = canvas.getContext('2d');
-      ctx.drawImage(img, 0, 0, newWidth, newHeight);
-
-      // Try with reduced dimensions
-      for (const quality of qualities) {
-        const dataUrl = canvas.toDataURL('image/jpeg', quality);
-        const sizeInBytes = Math.ceil((dataUrl.length - 'data:image/jpeg;base64,'.length) * 0.75);
-
-        if (sizeInBytes <= this.MAX_IMAGE_SIZE_BYTES) {
-          return dataUrl;
-        }
-      }
-
-      // Last resort: heavily compressed small image
-      const smallCanvas = createCanvas(Math.floor(newWidth * 0.5), Math.floor(newHeight * 0.5));
-      const smallCtx = smallCanvas.getContext('2d');
-      smallCtx.drawImage(img, 0, 0, smallCanvas.width, smallCanvas.height);
-
-      return smallCanvas.toDataURL('image/jpeg', 0.3);
-
-    } catch (error) {
-      // Enhanced error logging for debugging
-      const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-      const errorStack = error instanceof Error ? error.stack : '';
-
-      console.error('PDF to image conversion detailed error:', {
-        message: errorMessage,
-        stack: errorStack,
-        errorType: error?.constructor?.name
-      });
-
-      throw new Error(`PDF to image conversion failed: ${errorMessage}`);
-    }
-  }
-  
-  static isScannedPDF(extractedText: string): boolean {
-    // Heuristics to detect scanned/image-only PDFs
-    const textLength = extractedText.trim().length;
-    const wordCount = extractedText.trim().split(/\s+/).filter(w => w.length > 0).length;
-    
-    // Consider it scanned if:
-    // - Very little text (< 50 characters)
-    // - Very few words (< 10 words)
-    // - High ratio of non-alphabetic characters
-    const nonAlphaRatio = (extractedText.length - extractedText.replace(/[^a-zA-Z]/g, '').length) / Math.max(extractedText.length, 1);
-    
-    return textLength < 50 || wordCount < 10 || nonAlphaRatio > 0.9;
-  }
-}

package/tests/data/console-test-1.txt

@@ -1 +0,0 @@
-Test file 1

package/tests/data/console-test-2.txt

@@ -1 +0,0 @@
-Test file 2

package/tests/data/console-test-long-filename-for-display-testing.txt

@@ -1 +0,0 @@
-Test with a very very long filename for testing

package/tests/data/failure.txt

@@ -1 +0,0 @@
-Test content for failure

package/tests/data/file1.txt

@@ -1 +0,0 @@
-Test content for file1

package/tests/data/file2.txt

@@ -1 +0,0 @@
-Test content for file2

package/tests/data/much-longer-filename-to-test-clearing.txt

@@ -1 +0,0 @@
-Test much longer filename content

package/tests/data/sample-markdown.md

@@ -1,9 +0,0 @@
-# Meeting Notes
-
-Date: 2024-03-15
-Attendees: John, Sarah, Mike
-
-## Action Items
-- Review budget proposal
-- Update project timeline
-- Schedule follow-up meeting

package/tests/data/sample-text.txt

@@ -1,25 +0,0 @@
-Project Requirements Document
-=========================
-
-Overview
---------
-This document outlines the requirements for the new customer management system.
-
-Features
---------
-1. User Authentication
-2. Customer Database
-3. Reporting Dashboard
-4. Data Export Functionality
-
-Technical Stack
---------------
-- Frontend: React.js
-- Backend: Node.js
-- Database: PostgreSQL
-
-Timeline
---------
-Development: 3 months
-Testing: 1 month
-Deployment: 2 weeks

package/tests/data/short.txt

@@ -1 +0,0 @@
-Test short filename content

package/tests/data/single-file.txt

@@ -1 +0,0 @@
-Test content for single file

package/tests/data/success.txt

@@ -1 +0,0 @@
-Test content for success

package/tests/data/this-is-a-very-long-filename-that-should-be-truncated-for-better-display-purposes.txt

@@ -1 +0,0 @@
-Test content for a long filename that should be truncated

package/tests/data/very-long-filename-that-should-be-cleared-properly.txt

@@ -1 +0,0 @@
-Test very long filename content

package/tests/data/x.txt

@@ -1 +0,0 @@
-Test x content