Trasversale · Workspace · Active
platform-shared-packages
Shared npm workspace that hosts contracts, frontend clients, observability helpers and UI primitives reused across Core and Experience repositories.
- npm workspaces
- CommonJS and ESM exports
Spec sheet
Role
Compile-time shared packages
Workspace
npm workspaces under packages/*
Package scope
@platform/*
Consumers
Core services, BFFs and frontends
Responsibilities
- Publish common DTO and type contracts.
- Provide cookie-aware and auth-specific frontend helpers.
- Provide agent execution contracts shared by platform-agent-service and product backends.
- Provide structured logging and request-context helpers for platform services.
- Seed shared design tokens for frontend alignment.
- Avoid contract duplication across sibling repositories.
Interfaces and contract surface
- npm query .workspace
- Package exports consumed via file: links
Internal modules
Package
@platform/contracts-auth
Shared auth DTO and type contract reused by services and frontends to avoid duplicate auth shapes.
Package
@platform/contracts-ai
Shared contract package for the internal AI generation API exposed by platform-ai-service.
Package
@platform/contracts-payments
Shared payment contract package for provider descriptors, pricing items, checkout sessions, purchase and subscription records, tenant plan status, and normalized payment event delivery.
Package
@platform/contracts-connectors
Shared connector contract package for service-to-service datasource integrations and product-facing adapter layers.
Package
@platform/contracts-agent
Shared type contract for asynchronous agent execution requests, MCP tool policy, tool trace, lifecycle statuses, usage data, callbacks and detail responses.
Package
@platform/auth-client
Thin auth client wrapper built on top of an injected apiFetch implementation and shared auth contracts.
Package
@platform/http-client
Cookie-aware HTTP client package intended for BFF-backed frontend applications in the workspace.
Package
@platform/observability
Shared request-context and structured logging helpers used by platform services to emit consistent JSON logs and request ids.
Package
@platform/ui
Initial shared UI package intended to host design tokens and alignment primitives for cross-project frontend consistency.
Consumers
Notes
- The integration rule for product code is to reuse an existing shared contract instead of redefining DTOs locally.
Source references
platform-shared-packages/README.mdplatform-shared-packages/package.jsonREADME.md