- Standardize Python SDK (`datastack`) documentation with a new multi-file suite. - Update `datastack-sdk` to serve as a backward-compatible shim for the canonical `datastack` package. - Update project manifest and memory map to reflect current SDK structure and v2.2.0 features.
52 lines
3.7 KiB
Markdown
52 lines
3.7 KiB
Markdown
# Dependencies Inventory & Rationales
|
|
|
|
This document audits all runtime dependencies, development tools, and client libraries used in DataStack, providing version numbers, licenses, and architectural rationales.
|
|
|
|
---
|
|
|
|
## 1. Node.js Production Dependencies
|
|
|
|
| Package | Version | License | Architectural Rationale |
|
|
| :--- | :--- | :--- | :--- |
|
|
| `next` | `^15.4.9` | MIT | App Router frontend framework, SSR rendering, Edge middleware, and standalone container packaging. |
|
|
| `react` | `^19.2.1` | MIT | Core UI component engine. |
|
|
| `react-dom` | `^19.2.1` | MIT | DOM rendering for React 19. |
|
|
| `express` | `^5.3.0` | MIT | High-performance, lightweight HTTP listener powering the dedicated Port 4000 ingestion server and `/internal/*` service bridge. |
|
|
| `socket.io` | `^4.8.4` | MIT | Real-time WebSocket server engine with automatic reconnection, heartbeat pings, and room/client management. |
|
|
| `socket.io-client`| `^4.8.4` | MIT | Client library for in-browser simulation (`/vcon/simulator`) and automated integration tests. |
|
|
| `pg` | `^8.23.1` | MIT | Robust PostgreSQL connection pool (`pg.Pool`) used strictly for control-plane metadata persistence. |
|
|
| `ioredis` | `^6.0.0` | MIT | High-speed Redis client supporting list buffering (`RPUSH`/`LPOP`), atomic trimming, and distributed flush locks (`SET NX PX`). |
|
|
| `jsonwebtoken` | `^9.0.3` | MIT | Fast HMAC-SHA256 signing and verification for SDK client authentication tokens. |
|
|
| `json2csv` | `^6.0.0-alpha.2` | MIT | High-performance transform streams for non-blocking CSV dataset extraction in `/api/export`. |
|
|
| `csv-parse` | `^7.0.3` | MIT | Stream-based parser for structured file ingestion and test verification. |
|
|
| `cors` | `^2.8.6` | MIT | Cross-origin resource sharing middleware for HTTP ingestion APIs. |
|
|
| `lucide-react` | `^0.553.0` | ISC | Clean, consistent SVG icon set across all UI components. |
|
|
| `motion` | `^12.23.24` | MIT | Smooth, declarative animations for dashboard counters, page transitions, and status badges. |
|
|
| `clsx` & `tailwind-merge` | `^2.1.1` / `^3.3.1` | MIT | Utility functions for conditional class concatenation and Tailwind utility conflict resolution (`cn()`). |
|
|
| `class-variance-authority`| `^0.7.1` | Apache-2.0 | Type-safe variant styling for UI primitives (`Button`, `Badge`, `Panel`). |
|
|
| `@hookform/resolvers` | `^5.2.1` | MIT | Form validation resolver support. |
|
|
| `@google/genai` | `^2.4.0` | Apache-2.0 | Google GenAI TypeScript SDK. |
|
|
|
|
---
|
|
|
|
## 2. Development & Tooling Dependencies
|
|
|
|
| Package | Version | License | Architectural Rationale |
|
|
| :--- | :--- | :--- | :--- |
|
|
| `typescript` | `^5` | Apache-2.0 | Static typing and compile-time contract enforcement across all source files. |
|
|
| `tsx` | `^4.21.0` | MIT | Native Node.js TypeScript runner used to execute integration test suites directly (`npx tsx --test`). |
|
|
| `@tailwindcss/postcss` | `4.1.11` | MIT | Next-generation Tailwind CSS v4 compiler. |
|
|
| `@tailwindcss/typography` | `^0.5.19` | MIT | Typography utility classes for documentation and markdown rendering. |
|
|
| `eslint` & `eslint-config-next` | `^9` / `^15.4.9` | MIT | Code quality analysis and style enforcement. |
|
|
| `@types/*` | Various | MIT | High-fidelity TypeScript definitions for Node, React, Express, PG, and JWT. |
|
|
|
|
---
|
|
|
|
## 3. Python SDK Dependencies (`sdk/python/datastack/`)
|
|
|
|
| Package | Version | License | Architectural Rationale |
|
|
| :--- | :--- | :--- | :--- |
|
|
| `python-socketio[client]` | `>=5.11.0` | MIT | WebSocket transport enabling real-time streaming with automatic reconnection. |
|
|
| `requests` | `>=2.31.0` | Apache-2.0 | Reliable HTTP transport for REST ingestion fallback and export downloads. |
|
|
| `urllib3` | `>=2.0.0` | MIT | Connection pooling and retry logic for network resiliency. |
|