{"_id":"@aleexpe03/n8n-nodes-finance-data-tools","name":"@aleexpe03/n8n-nodes-finance-data-tools","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@aleexpe03/n8n-nodes-finance-data-tools","version":"0.1.0","description":"Self-hosted n8n community nodes for finance data quality, ratios, accounting validation, reporting, predictive analytics, and AI Agent tools.","license":"MIT","homepage":"https://github.com/apalmaescamez-hue/n8n-nodes-finance-data-tools#readme","repository":{"type":"git","url":"git+https://github.com/apalmaescamez-hue/n8n-nodes-finance-data-tools.git"},"bugs":{"url":"https://github.com/apalmaescamez-hue/n8n-nodes-finance-data-tools/issues"},"keywords":["n8n-community-node-package","n8n","finance","data-quality","profiling","cleaning","ratios","accounting","reporting","reports","forecasting","predictive-analytics","ai-agent","ai-tool"],"author":{"name":"apalmaescamez-hue"},"main":"dist/nodes/DataProfiler/DataProfiler.node.js","types":"dist/nodes/DataProfiler/DataProfiler.node.d.ts","scripts":{"build":"n8n-node build","dev":"n8n-node dev","lint":"n8n-node lint","lint:fix":"n8n-node lint --fix","test":"vitest run","test:watch":"vitest"},"n8n":{"n8nNodesApiVersion":1,"nodes":["dist/nodes/DataProfiler/DataProfiler.node.js","dist/nodes/DataCleaner/DataCleaner.node.js","dist/nodes/DataNormalizer/DataNormalizer.node.js","dist/nodes/MathStatistics/MathStatistics.node.js","dist/nodes/FinancialRatios/FinancialRatios.node.js","dist/nodes/AccountingValidator/AccountingValidator.node.js","dist/nodes/FinancialReportBuilder/FinancialReportBuilder.node.js","dist/nodes/PredictiveAnalytics/PredictiveAnalytics.node.js","dist/nodes/AiFinanceTool/AiFinanceTool.node.js"]},"dependencies":{"date-fns":"^4.1.0","decimal.js":"^10.6.0","simple-statistics":"^7.8.9","zod":"^4.4.3"},"devDependencies":{"@n8n/node-cli":"^0.29.1","eslint":"9.29.0","n8n-workflow":"^2.16.0","typescript":"^6.0.3","vitest":"^4.1.5"},"publishConfig":{"access":"public"},"_id":"@aleexpe03/n8n-nodes-finance-data-tools@0.1.0","gitHead":"509efcf2d30dd451c4ccfe00ebf160d9ea5df60c","_nodeVersion":"20.19.3","_npmVersion":"10.8.2","dist":{"integrity":"sha512-hfgP1QRS6f/6fFcoyf60RTtif/r1XWnZZX+LjZ6RA+WyA39pnwm4bYj/PsdDwXPQWF9Y4ZmrKYY/wQ++nFx2Dg==","shasum":"47698592631a58b20508b4ab3b5602bc21aaf091","tarball":"https://registry.npmjs.org/@aleexpe03/n8n-nodes-finance-data-tools/-/n8n-nodes-finance-data-tools-0.1.0.tgz","fileCount":158,"unpackedSize":715242,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCKvP7n1XM5U05nOWfyNkKYSkaIRynlv18tNP290DN7sAIhAKnu1hSJ5LjZghRJQw06eyvfKwPsDaW3W+dKhnNr1cc6"}]},"_npmUser":{"name":"aleexpe03","email":"apalmaescamez@gmail.com"},"directories":{},"maintainers":[{"name":"aleexpe03","email":"apalmaescamez@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/n8n-nodes-finance-data-tools_0.1.0_1778329305100_0.8295114519421083"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-09T12:21:44.948Z","0.1.0":"2026-05-09T12:21:45.263Z","modified":"2026-05-09T12:21:45.528Z"},"maintainers":[{"name":"aleexpe03","email":"apalmaescamez@gmail.com"}],"description":"Self-hosted n8n community nodes for finance data quality, ratios, accounting validation, reporting, predictive analytics, and AI Agent tools.","homepage":"https://github.com/apalmaescamez-hue/n8n-nodes-finance-data-tools#readme","keywords":["n8n-community-node-package","n8n","finance","data-quality","profiling","cleaning","ratios","accounting","reporting","reports","forecasting","predictive-analytics","ai-agent","ai-tool"],"repository":{"type":"git","url":"git+https://github.com/apalmaescamez-hue/n8n-nodes-finance-data-tools.git"},"author":{"name":"apalmaescamez-hue"},"bugs":{"url":"https://github.com/apalmaescamez-hue/n8n-nodes-finance-data-tools/issues"},"license":"MIT","readme":"# @aleexpe03/n8n-nodes-finance-data-tools\n\nCommunity node package for finance-oriented data quality, deterministic finance calculations, reporting, predictive analytics, and AI Agent wrappers in n8n.\n\nThis package is currently prepared as a self-hosted MVP. It is not published to npm from this repository state, and official n8n verification is not claimed.\n\n## Implemented nodes\n\n| Node | Purpose | Main operations |\n| --- | --- | --- |\n| Data Profiler | Profiles tabular JSON rows before finance preparation. | `profileDataset` |\n| Data Cleaner | Cleans finance-oriented tabular rows. | `cleanDataset` |\n| Data Normalizer | Maps and normalizes finance columns. | `normalizeDataset` |\n| Math & Statistics | Runs allowlisted statistics and finance-safe math. | Summary statistics, percentile, correlation, growth, CAGR, z-score, IQR outliers, grouped aggregates |\n| Financial Ratios | Calculates closed financial ratios from one aggregated finance object. | Profitability, liquidity, leverage, returns, growth, cash-flow, efficiency, unit economics |\n| Accounting Validator | Validates journals and can generate a minimal trial balance. | Validate journal entries, validate and build trial balance, build trial balance |\n| Financial Report Builder | Builds deterministic financial report JSON. | Executive summary, P&L, balance sheet, cash summary, KPI table, dashboard JSON, AI Agent report |\n| Predictive Analytics | Runs explainable directional forecasting. | Moving average, CAGR forecast, trend forecast, simple linear regression |\n| AI Finance Tool | Controlled facade for AI Agents. | Data, finance, accounting, report, and opt-in predictive operations |\n\n## Documentation\n\n- [Self-hosted installation and local development](docs/installation-self-hosted.md)\n- [AI Agent wrapper guide](docs/ai-agent-wrapper.md)\n- [Output contract](docs/output-contract.md)\n- [Security and limitations](docs/security-and-limitations.md)\n- [Testing strategy](docs/testing-strategy.md)\n- [Release checklist](docs/release-checklist.md)\n\n## Example workflow templates\n\nEditable workflow templates live in [`examples/workflows/`](examples/workflows/):\n\n- [`data-quality-wrapper.workflow.json`](examples/workflows/data-quality-wrapper.workflow.json)\n- [`financial-ratios-wrapper.workflow.json`](examples/workflows/financial-ratios-wrapper.workflow.json)\n- [`accounting-validator-wrapper.workflow.json`](examples/workflows/accounting-validator-wrapper.workflow.json)\n- [`ai-finance-tool-wrapper.workflow.json`](examples/workflows/ai-finance-tool-wrapper.workflow.json)\n\nThe templates are intentionally marked as editable. If your n8n instance reports an unknown custom-node type during import, install/load this package first and confirm the exact node type shown by your n8n version.\n\n## Self-hosted status\n\nThe MVP target is self-hosted n8n. Current documentation does not promise n8n Cloud availability or official verified-community-node status.\n\nImportant verification note: the package currently uses runtime dependencies (`date-fns`, `decimal.js`, `simple-statistics`, and `zod`). n8n's current verification guidance expects verified packages to avoid external runtime dependencies, so official verification requires a dependency strategy review before submission.\n\n## Local development commands\n\n```bash\nnpm test\nnpm run lint\nnpm run dev\n```\n\n`npm run dev` is the local n8n development path provided by the n8n node tooling. `npm run build` exists in `package.json`, but it is intentionally not part of this phase's executed validation.\n\n## Standard output envelope\n\nAll nodes return a shared envelope:\n\n```json\n{\n  \"success\": true,\n  \"operation\": \"profileDataset\",\n  \"data\": {},\n  \"metadata\": {\n    \"generatedAt\": \"2026-05-09T00:00:00.000Z\",\n    \"durationMs\": 0,\n    \"rowCount\": 0,\n    \"columnCount\": 0\n  },\n  \"warnings\": [],\n  \"errors\": [],\n  \"auditTrail\": []\n}\n```\n\nSee [Output contract](docs/output-contract.md) for field-level semantics and predictive-output details.\n\n## Architecture\n\nThe n8n nodes are thin adapters. Domain logic lives in pure TypeScript services under:\n\n- `domain/data/profiling/`\n- `domain/data/cleaning/`\n- `domain/data/normalization/`\n- `domain/math/statistics/`\n- `domain/finance/ratios/`\n- `domain/finance/reports/`\n- `domain/accounting/`\n- `domain/ml/forecasting/`\n- `domain/ai/financeTool/`\n\nShared output, audit, error, and type helpers live in `shared/`.\n\n## Safety model\n\n- No Python runtime.\n- No external APIs or microservices.\n- No filesystem or environment-variable access in domain logic.\n- No `eval`, formula interpreter, or arbitrary user-code execution.\n- Operations are allowlisted and deterministic.\n- Predictive output is directional, not a guarantee, and must surface warnings.\n\nSee [Security and limitations](docs/security-and-limitations.md) for the full model.\n\r\n","readmeFilename":"README.md","_rev":"1-ea5c2e1e8d5ee3a6f58e92fe12ff6d2a"}