Files
Team Dark Devil 40a6855724 feat(sdk): refactor Python SDK documentation
- 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.
2026-11-18 10:03:40 +06:00

3.7 KiB

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.