@pocket-portfolio/universal-csv-importer 1.0.0

package/README.md

@@ -0,0 +1,88 @@
+# @pocket-portfolio/universal-csv-importer
+
+Parse **any** broker CSV with **Smart Mapping** – no broker-specific adapter required.
+
+Import trading history from any CSV (unknown broker, custom export, or spreadsheet) by mapping columns once. Heuristic-based mapping works out of the box; no API keys needed.
+
+## Installation
+
+```bash
+npm install @pocket-portfolio/universal-csv-importer
+```
+
+## Usage
+
+### Quick: parse with automatic column inference
+
+```javascript
+const { parseUniversal } = require('@pocket-portfolio/universal-csv-importer');
+
+const file = /* File or { name, arrayBuffer, ... } */;
+const result = await parseUniversal(file, 'en-US');
+
+if (result.trades) {
+  console.log(`Parsed ${result.trades.length} trades`);
+} else {
+  // result.type === 'REQUIRES_MAPPING' – show UI to confirm/edit column mapping
+  console.log('Headers:', result.headers);
+  console.log('Proposed mapping:', result.proposedMapping);
+  // Then call genericParse(result.rawCsvText, userMapping, 'en-US') with final mapping
+}
+```
+
+### With explicit column mapping
+
+```javascript
+const { genericParse } = require('@pocket-portfolio/universal-csv-importer');
+
+const csvText = 'Date,Symbol,Action,Qty,Price\n...';
+const mapping = {
+  date: 'Date',
+  ticker: 'Symbol',
+  action: 'Action',
+  quantity: 'Qty',
+  price: 'Price',
+};
+const result = genericParse(csvText, mapping, 'en-US');
+console.log(result.trades.length);
+```
+
+### Infer mapping only (for custom UIs)
+
+```javascript
+const { inferMapping } = require('@pocket-portfolio/universal-csv-importer');
+
+const { mapping, confidence, source } = await inferMapping({
+  headers: ['Date', 'Symbol', 'Type', 'Qty', 'Price'],
+  sampleRows: [/* first few rows */],
+});
+// Use mapping in your UI; source is 'heuristic' or 'llm'
+```
+
+## Smart Mapping
+
+- **Heuristics:** Built-in synonyms match common column names (Date, Symbol, Action, Qty, Price, etc.) so most CSVs map automatically.
+- **Optional LLM:** When used inside an app that provides an LLM endpoint, low-confidence cases can be improved; the package works without it.
+
+## Types (TypeScript)
+
+For `UniversalMapping`, `RequiresMappingResult`, `StandardField`, etc., use the core package:
+
+```ts
+import type { UniversalMapping, RequiresMappingResult } from '@pocket-portfolio/importer';
+```
+
+## Related
+
+- [@pocket-portfolio/importer](https://www.npmjs.com/package/@pocket-portfolio/importer) – Core library (broker-specific parsers + universal API)
+- [Pocket Portfolio](https://www.pocketportfolio.app) – Free portfolio tracker
+
+## Support the project
+
+This package is **100% free and open-source**.
+
+**[Support the work → pocketportfolio.app/sponsor](https://www.pocketportfolio.app/sponsor)**
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,28 @@
+/**
+ * Universal CSV Importer – Smart Mapping for any broker
+ *
+ * This package exposes only the Universal Import API from @pocket-portfolio/importer:
+ * parseUniversal, genericParse, genericRowToTrade, inferMapping.
+ * For TypeScript types (UniversalMapping, RequiresMappingResult, etc.) use the core package.
+ *
+ * @example
+ * ```javascript
+ * const { parseUniversal, genericParse, inferMapping } = require('@pocket-portfolio/universal-csv-importer');
+ *
+ * // Parse with automatic column inference (returns ParseResult or RequiresMappingResult)
+ * const result = await parseUniversal(file, 'en-US');
+ * if (result.type === 'REQUIRES_MAPPING') {
+ *   // Show UI for user to confirm/edit mapping, then:
+ *   const parsed = genericParse(result.rawCsvText, userMapping, 'en-US');
+ * }
+ * ```
+ */
+
+const importer = require('@pocket-portfolio/importer');
+
+module.exports = {
+  parseUniversal: importer.parseUniversal,
+  genericParse: importer.genericParse,
+  genericRowToTrade: importer.genericRowToTrade,
+  inferMapping: importer.inferMapping,
+};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@pocket-portfolio/universal-csv-importer",
+  "version": "1.0.0",
+  "description": "Parse any broker CSV with smart column mapping. No broker-specific adapter required. Free & open-source. Support: pocketportfolio.app/sponsor",
+  "main": "index.js",
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "keywords": [
+    "universal",
+    "csv",
+    "importer",
+    "smart mapping",
+    "column mapping",
+    "any broker",
+    "portfolio",
+    "finance",
+    "trading",
+    "typescript",
+    "pocket-portfolio"
+  ],
+  "author": "Pocket Portfolio",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PocketPortfolio/Financialprofilenetwork.git",
+    "directory": "packages/aliases/universal-csv-importer"
+  },
+  "dependencies": {
+    "@pocket-portfolio/importer": "^1.1.0"
+  },
+  "files": [
+    "index.js",
+    "README.md",
+    "scripts"
+  ],
+  "homepage": "https://www.pocketportfolio.app",
+  "bugs": {
+    "url": "https://github.com/PocketPortfolio/Financialprofilenetwork/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,24 @@
+// Terminal Billboard - Founder's Club Promotion
+const reset = "\x1b[0m";
+const bright = "\x1b[1m";
+const cyan = "\x1b[36m";
+const yellow = "\x1b[33m";
+const red = "\x1b[31m";
+const bgOrange = "\x1b[48;5;208m";
+const black = "\x1b[30m";
+
+console.log(`
+${cyan}╔══════════════════════════════════════════════════════════════╗${reset}
+${cyan}║                                                              ║${reset}
+${cyan}║   ${bright}🚀 Thanks for installing Universal CSV Importer!${reset}${cyan}         ║${reset}
+${cyan}║                                                              ║${reset}
+${cyan}║   ${yellow}We remain 100% Free & Open Source because of you.${reset}${cyan}          ║${reset}
+${cyan}║                                                              ║${reset}
+${cyan}║   ${bgOrange}${black} UK FOUNDER'S CLUB - BATCH 1 ${reset}${cyan}                             ║${reset}
+${cyan}║   ${red}🔥 Only 42/50 Lifetime Spots Remaining${reset}${cyan}                     ║${reset}
+${cyan}║                                                              ║${reset}
+${cyan}║   ${bright}Claim your Badge & Lifetime Access here:${reset}${cyan}                   ║${reset}
+${cyan}║   👉 https://www.pocketportfolio.app/sponsor?ref=npm         ║${reset}
+${cyan}║                                                              ║${reset}
+${cyan}╚══════════════════════════════════════════════════════════════╝${reset}
+`);