@amirdaraee/namewise 0.9.0 → 1.0.0

package/dist/utils/retry.d.ts

@@ -0,0 +1,15 @@
+export interface RetryOptions {
+    /** Total attempts including the first call. Default 3. */
+    attempts?: number;
+    /** Delay before the first retry; doubles each subsequent retry. Default 1000ms. */
+    baseDelayMs?: number;
+    /** Injectable for tests. */
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * Retries transient AI-provider failures (rate limits, network/5xx errors)
+ * with exponential backoff. Everything else — auth, parse, programming
+ * errors — is rethrown immediately.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, opts?: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CAiB5F"}

package/dist/utils/retry.js

@@ -0,0 +1,26 @@
+import { RateLimitError, NetworkError } from '../errors.js';
+/**
+ * Retries transient AI-provider failures (rate limits, network/5xx errors)
+ * with exponential backoff. Everything else — auth, parse, programming
+ * errors — is rethrown immediately.
+ */
+export async function withRetry(fn, opts = {}) {
+    const attempts = opts.attempts ?? 3;
+    const base = opts.baseDelayMs ?? 1000;
+    const sleep = opts.sleep ?? (ms => new Promise(resolve => setTimeout(resolve, ms)));
+    let lastError;
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            const retryable = error instanceof RateLimitError || error instanceof NetworkError;
+            if (!retryable || attempt === attempts)
+                throw error;
+            await sleep(base * 2 ** (attempt - 1));
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAW5D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,EAAoB,EAAE,OAAqB,EAAE;IAC9E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAE1F,IAAI,SAAkB,CAAC;IACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,MAAM,SAAS,GAAG,KAAK,YAAY,cAAc,IAAI,KAAK,YAAY,YAAY,CAAC;YACnF,IAAI,CAAC,SAAS,IAAI,OAAO,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;YACpD,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,MAAM,SAAS,CAAC;AAClB,CAAC"}

package/dist/utils/sanitizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sanitizer.d.ts","sourceRoot":"","sources":["../../src/utils/sanitizer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,gBAA+B,GAAG,MAAM,CAOlG"}
+{"version":3,"file":"sanitizer.d.ts","sourceRoot":"","sources":["../../src/utils/sanitizer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,gBAA+B,GAAG,MAAM,CAQlG"}

package/dist/utils/sanitizer.js

@@ -2,6 +2,7 @@ import { applyNamingConvention, stripWindowsIllegalChars } from './naming-conven
 export function sanitizeFilename(stem, convention = 'kebab-case') {
     let result = stem.normalize('NFC');
     result = stripWindowsIllegalChars(result);
+    // eslint-disable-next-line no-control-regex -- stripping control chars from filenames is the point
     result = result.replace(/[\x00-\x1F\x7F]/g, '');
     result = applyNamingConvention(result, convention);
     if (result.length > 200)

package/dist/utils/sanitizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"sanitizer.js","sourceRoot":"","sources":["../../src/utils/sanitizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAG1F,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,aAA+B,YAAY;IACxF,IAAI,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,GAAG,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"sanitizer.js","sourceRoot":"","sources":["../../src/utils/sanitizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAG1F,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,aAA+B,YAAY;IACxF,IAAI,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC1C,mGAAmG;IACnG,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,GAAG,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/eslint.config.js

@@ -0,0 +1,27 @@
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  { ignores: ['dist/', 'coverage/', 'node_modules/'] },
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    rules: {
+      // CLI tool: interfaces accept broad option bags; explicit any is a
+      // deliberate escape hatch, unused args prefixed with _ are intentional
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        { argsIgnorePattern: '^_', varsIgnorePattern: '^_', caughtErrors: 'none' }
+      ]
+    }
+  },
+  {
+    files: ['tests/**'],
+    rules: {
+      '@typescript-eslint/no-require-imports': 'off',
+      // mocks legitimately wrap arbitrary callbacks
+      '@typescript-eslint/no-unsafe-function-type': 'off'
+    }
+  }
+);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amirdaraee/namewise",
-  "version": "0.9.0",
+  "version": "1.0.0",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
@@ -17,6 +17,9 @@
     "test:watch": "vitest --watch",
     "test:unit": "vitest run tests/unit",
     "test:integration": "vitest run tests/integration",
+    "lint": "eslint .",
+    "smoke:generate": "tsx scripts/generate-smoke-corpus.ts",
+    "smoke": "npm run build && npm run smoke:generate && node dist/index.js rename smoke-corpus --dry-run",
     "version:patch": "npm version patch",
     "version:minor": "npm version minor",
     "version:major": "npm version major",
@@ -53,6 +56,7 @@
   "license": "MIT",
   "description": "AI-powered CLI tool that intelligently renames files based on their content using Claude or OpenAI",
   "devDependencies": {
+    "@eslint/js": "10.0.1",
     "@types/fs-extra": "^11.0.4",
     "@types/heic-convert": "2.1.0",
     "@types/inquirer": "^9.0.9",
@@ -60,14 +64,15 @@
     "@types/pdfkit": "0.17.5",
     "@vitest/coverage-v8": "^3.2.4",
     "@vitest/ui": "^3.2.4",
+    "eslint": "10.4.1",
     "pdfkit": "0.8.3",
     "tsx": "4.21.0",
     "typescript": "^5.9.2",
+    "typescript-eslint": "8.61.0",
     "vitest": "^3.2.4"
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.61.0",
-    "canvas": "3.2.3",
     "chalk": "5.6.2",
     "chokidar": "5.0.0",
     "commander": "14.0.3",
@@ -80,7 +85,10 @@
     "openai": "^5.19.1",
     "ora": "9.3.0",
     "pdf-extraction": "^1.0.2",
-    "pdf-to-png-converter": "3.14.0",
     "pdfjs-dist": "5.4.149"
+  },
+  "optionalDependencies": {
+    "canvas": "3.2.3",
+    "pdf-to-png-converter": "3.14.0"
   }
 }

package/scripts/generate-smoke-corpus.ts

@@ -0,0 +1,138 @@
+/**
+ * Smoke-test corpus generator — manual pre-release quality check, NOT CI.
+ *
+ * Generates ~10 deliberately messy files in ./smoke-corpus/ that mimic what
+ * real users point namewise at: scanner default names, "Untitled-final(2)"
+ * documents, Windows "New Text Document.txt", etc.
+ *
+ * Usage:
+ *   npm run smoke:generate          # just (re)create the corpus
+ *   npm run smoke                   # build + generate + dry-run rename with
+ *                                   # your configured provider/API key
+ *
+ * Eyeball the suggested names: are they descriptive, correctly categorized,
+ * and in the right language? This doubles as the prompt-tuning feedback loop.
+ */
+import { existsSync, mkdirSync, rmSync, writeFileSync } from 'fs';
+import path from 'path';
+import Excel from 'exceljs';
+import PDFDocument from 'pdfkit';
+
+const CORPUS_DIR = path.join(process.cwd(), 'smoke-corpus');
+
+function createPdfBuffer(write: (doc: InstanceType<typeof PDFDocument>) => void): Promise<Buffer> {
+  return new Promise<Buffer>((resolve, reject) => {
+    const doc = new PDFDocument({ size: 'A4', autoFirstPage: true });
+    const chunks: Buffer[] = [];
+    doc.on('data', (chunk: Buffer) => chunks.push(chunk));
+    doc.on('end', () => {
+      const pdfBuf = Buffer.concat(chunks);
+      // pdfjs v1.x misreads small pooled Buffers (byteOffset > 0); padding past
+      // 4096 bytes forces a dedicated allocation — same trick as the test fixtures.
+      if (pdfBuf.length > 4096) {
+        resolve(pdfBuf);
+      } else {
+        const pad = Buffer.alloc(4097 - pdfBuf.length, 0x20);
+        resolve(Buffer.concat([pdfBuf, Buffer.from('\n%padded\n'), pad]));
+      }
+    });
+    doc.on('error', reject);
+    write(doc);
+    doc.end();
+  });
+}
+
+async function main(): Promise<void> {
+  if (existsSync(CORPUS_DIR)) rmSync(CORPUS_DIR, { recursive: true });
+  mkdirSync(CORPUS_DIR, { recursive: true });
+
+  // 1. Scanner default name, real text content (invoice)
+  writeFileSync(
+    path.join(CORPUS_DIR, 'scan0001.pdf'),
+    await createPdfBuffer(doc => {
+      doc.fontSize(18).text('INVOICE #2024-0312');
+      doc.fontSize(11).text('\nBilled to: Riverside Dental Clinic\nDate: March 12, 2024\n\nDescription: Annual website maintenance and hosting\nAmount due: $1,450.00\nPayment due within 30 days.');
+    })
+  );
+
+  // 2. The classic "final final" document (meeting notes)
+  writeFileSync(
+    path.join(CORPUS_DIR, 'Untitled-final(2).pdf'),
+    await createPdfBuffer(doc => {
+      doc.fontSize(14).text('Product Team Meeting Notes');
+      doc.fontSize(11).text('\nDate: June 3, 2026\nAttendees: Sara, Mike, Priya\n\nDecisions:\n- Ship onboarding redesign in July\n- Defer mobile dark mode to Q4\n- Hire one more backend engineer');
+    })
+  );
+
+  // 3. Image-only PDF (no selectable text) — exercises the scanned-PDF vision path
+  writeFileSync(
+    path.join(CORPUS_DIR, 'Scan_2023_11_30.pdf'),
+    await createPdfBuffer(doc => {
+      doc.rect(0, 0, doc.page.width, doc.page.height).fill('white');
+    })
+  );
+
+  // 4. Windows default name, recipe content
+  writeFileSync(
+    path.join(CORPUS_DIR, 'New Text Document.txt'),
+    'Grandma\'s lemon poppy seed muffins\n\nIngredients: 2 cups flour, 3/4 cup sugar, 2 tbsp poppy seeds, zest of 2 lemons, 1 cup buttermilk, 2 eggs.\nBake at 190C for 18-20 minutes. Makes 12 muffins.\n'
+  );
+
+  // 5. Keyboard-mash name, project README content
+  writeFileSync(
+    path.join(CORPUS_DIR, 'asdf.md'),
+    '# Inventory Sync Service\n\nSyncs warehouse inventory counts between Shopify and the internal ERP every 15 minutes.\n\n## Setup\n\n```bash\nnpm install && npm start\n```\n'
+  );
+
+  // 6. Vague sequential name, insurance letter
+  writeFileSync(
+    path.join(CORPUS_DIR, 'document1.txt'),
+    'Dear Policyholder,\n\nThis letter confirms the renewal of your home insurance policy HO-2291-B effective January 1, 2026. Your annual premium is $1,184. Coverage includes fire, theft, and water damage up to $450,000.\n\nNorthstar Insurance Group\n'
+  );
+
+  // 7. "(copy)" suffix, travel itinerary
+  writeFileSync(
+    path.join(CORPUS_DIR, 'notes (copy).md'),
+    '# Lisbon Trip\n\n- Flight TP 942, departs May 14 08:25\n- Hotel: Casa do Bairro, Alfama (3 nights)\n- Day 2: Sintra day trip, Pena Palace tickets booked\n- Day 3: Time Out Market, Fado show 21:00\n'
+  );
+
+  // 8. The infamous final-FINAL, CSV-ish sales data
+  writeFileSync(
+    path.join(CORPUS_DIR, 'data-export-final-FINAL.txt'),
+    'region,month,units,revenue\nNorth,2026-01,412,20600\nNorth,2026-02,498,24900\nSouth,2026-01,377,18850\nSouth,2026-02,401,20050\n'
+  );
+
+  // 9. Excel default workbook name, household budget
+  const workbook = new Excel.Workbook();
+  const sheet = workbook.addWorksheet('Budget');
+  sheet.addRow(['Category', 'Monthly budget', 'Actual']);
+  sheet.addRow(['Rent', 2100, 2100]);
+  sheet.addRow(['Groceries', 600, 684]);
+  sheet.addRow(['Transport', 150, 121]);
+  sheet.addRow(['Savings', 800, 800]);
+  await workbook.xlsx.writeFile(path.join(CORPUS_DIR, 'Book1.xlsx'));
+
+  // 10. Camera default name, image with drawn text (needs optional canvas)
+  try {
+    const { createCanvas } = await import('canvas');
+    const canvas = createCanvas(800, 500);
+    const ctx = canvas.getContext('2d');
+    ctx.fillStyle = '#f4e8d0';
+    ctx.fillRect(0, 0, 800, 500);
+    ctx.fillStyle = '#222';
+    ctx.font = 'bold 42px sans-serif';
+    ctx.fillText('FARMERS MARKET', 180, 200);
+    ctx.font = '28px sans-serif';
+    ctx.fillText('Every Saturday 8am - 1pm, Oak Street Square', 90, 280);
+    writeFileSync(path.join(CORPUS_DIR, 'IMG_20240315_0042.jpg'), canvas.toBuffer('image/jpeg'));
+  } catch {
+    console.log('  (canvas not installed — skipping the image fixture)');
+  }
+
+  console.log(`Smoke corpus written to ${CORPUS_DIR}`);
+}
+
+main().catch(err => {
+  console.error(err);
+  process.exit(1);
+});