@powerhousedao/switchboard 4.0.4 → 4.1.0-dev.10

package/CHANGELOG.md

@@ -1,16 +1,18 @@
-## 4.0.4 (2025-07-31)
+## 4.1.0-dev.10 (2025-08-07)
 
-This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
+### 🚀 Features
 
-## 4.0.3 (2025-07-31)
+- **builder-tools,codegen,design-system,reactor-api:** updated document-engineering version ([e74068b43](https://github.com/powerhouse-inc/powerhouse/commit/e74068b43))
 
-This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
+### ❤️ Thank You
 
-## 4.0.2 (2025-07-31)
+- acaldas @acaldas
+
+## 4.1.0-dev.9 (2025-08-07)
 
 This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
 
-## 4.0.1 (2025-07-25)
+## 4.1.0-dev.8 (2025-08-06)
 
 ### 🚀 Features
 
@@ -20,15 +22,152 @@ This was a version bump only for @powerhousedao/switchboard to align it with oth
 
 - acaldas @acaldas
 
-# 4.0.0 (2025-07-24)
+## 4.1.0-dev.7 (2025-08-06)
+
+### 🚀 Features
+
+- **switchboard:** added readme ([fbadfca11](https://github.com/powerhouse-inc/powerhouse/commit/fbadfca11))
+
+### ❤️ Thank You
+
+- Frank
+
+## 4.1.0-dev.6 (2025-08-06)
+
+### 🚀 Features
+
+- **reactor-mcp:** load local document models and reload when they change ([0408a017c](https://github.com/powerhouse-inc/powerhouse/commit/0408a017c))
+- **reactor-local,reactor-api,document-drive:** reload local document models when they change ([5d9af3951](https://github.com/powerhouse-inc/powerhouse/commit/5d9af3951))
+
+### ❤️ Thank You
+
+- acaldas @acaldas
+
+## 4.1.0-dev.5 (2025-08-05)
+
+This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
+
+## 4.1.0-dev.4 (2025-08-02)
+
+### 🚀 Features
+
+- ts morph integration ([#1729](https://github.com/powerhouse-inc/powerhouse/pull/1729))
+
+### ❤️ Thank You
+
+- Guillermo Puente Sandoval @gpuente
+
+## 4.1.0-dev.3 (2025-08-01)
+
+### 🚀 Features
+
+- **reactor-mcp:** setup of modular reactor tools ([ceab98b08](https://github.com/powerhouse-inc/powerhouse/commit/ceab98b08))
+
+### ❤️ Thank You
+
+- acaldas @acaldas
+
+## 4.1.0-dev.2 (2025-07-31)
+
+### 🚀 Features
+
+- **reactor-mcp,document/model:** initial implementation of reactor mcp ([4eaab9ab0](https://github.com/powerhouse-inc/powerhouse/commit/4eaab9ab0))
+
+### 🩹 Fixes
+
+- linter issues ([e55a16456](https://github.com/powerhouse-inc/powerhouse/commit/e55a16456))
+
+### ❤️ Thank You
+
+- acaldas @acaldas
+- Benjamin Jordan (@thegoldenmule)
+
+## 4.1.0-dev.1 (2025-07-29)
+
+### 🚀 Features
+
+- added vetra command and vetra project ([#1713](https://github.com/powerhouse-inc/powerhouse/pull/1713))
+
+### ❤️ Thank You
+
+- Guillermo Puente Sandoval @gpuente
+
+## 4.0.0-staging.8 (2025-07-29)
 
 This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
 
-## 4.0.0-staging.5 (2025-07-23)
+## 4.0.0-staging.7 (2025-07-26)
+
+### 🚀 Features
+
+- **state:** make all atom states derivative ([68a4bfece](https://github.com/powerhouse-inc/powerhouse/commit/68a4bfece))
+
+### 🩹 Fixes
+
+- **switchboard:** remove auth from switchboard config ([ff3410afc](https://github.com/powerhouse-inc/powerhouse/commit/ff3410afc))
+
+### ❤️ Thank You
+
+- Frank
+- ryanwolhuter @ryanwolhuter
+
+## 4.0.0-staging.6 (2025-07-25)
+
+### 🚀 Features
+
+- **connect:** remove unused dep ([00d3f68c0](https://github.com/powerhouse-inc/powerhouse/commit/00d3f68c0))
+- **state:** use reactor on window object ([40321826e](https://github.com/powerhouse-inc/powerhouse/commit/40321826e))
+- **state:** add state package reference to monorepo tsconfig ([93de86073](https://github.com/powerhouse-inc/powerhouse/commit/93de86073))
+- **state:** remove unused deps ([d681fff7a](https://github.com/powerhouse-inc/powerhouse/commit/d681fff7a))
+- **state:** remove jotai optics dep ([dfc955a82](https://github.com/powerhouse-inc/powerhouse/commit/dfc955a82))
+- **common:** add storybook react dev dep ([61404f414](https://github.com/powerhouse-inc/powerhouse/commit/61404f414))
+- **common:** install storybook types ([c4d45bb7c](https://github.com/powerhouse-inc/powerhouse/commit/c4d45bb7c))
+- **connect:** use new hooks ([93a9eccfa](https://github.com/powerhouse-inc/powerhouse/commit/93a9eccfa))
+- **state:** move state code to own package ([605bd5d75](https://github.com/powerhouse-inc/powerhouse/commit/605bd5d75))
+- support initial strand without operations ([46698d2ff](https://github.com/powerhouse-inc/powerhouse/commit/46698d2ff))
+- **document-drive:** removed drive id where possible ([adcedc4f0](https://github.com/powerhouse-inc/powerhouse/commit/adcedc4f0))
+
+### 🩹 Fixes
+
+- **document-drive:** added deprecation warnings and release notes ([dbc86d172](https://github.com/powerhouse-inc/powerhouse/commit/dbc86d172))
+- **common:** update storybook story type ([a84550281](https://github.com/powerhouse-inc/powerhouse/commit/a84550281))
+
+### ❤️ Thank You
+
+- acaldas @acaldas
+- ryanwolhuter @ryanwolhuter
+
+## 3.3.0-dev.19 (2025-07-25)
+
+### 🚀 Features
+
+- **connect:** remove unused dep ([00d3f68c0](https://github.com/powerhouse-inc/powerhouse/commit/00d3f68c0))
+- **state:** use reactor on window object ([40321826e](https://github.com/powerhouse-inc/powerhouse/commit/40321826e))
+- **state:** add state package reference to monorepo tsconfig ([93de86073](https://github.com/powerhouse-inc/powerhouse/commit/93de86073))
+- **state:** remove unused deps ([d681fff7a](https://github.com/powerhouse-inc/powerhouse/commit/d681fff7a))
+- **state:** remove jotai optics dep ([dfc955a82](https://github.com/powerhouse-inc/powerhouse/commit/dfc955a82))
+- **common:** add storybook react dev dep ([61404f414](https://github.com/powerhouse-inc/powerhouse/commit/61404f414))
+- **common:** install storybook types ([c4d45bb7c](https://github.com/powerhouse-inc/powerhouse/commit/c4d45bb7c))
+- **connect:** use new hooks ([93a9eccfa](https://github.com/powerhouse-inc/powerhouse/commit/93a9eccfa))
+- **state:** move state code to own package ([605bd5d75](https://github.com/powerhouse-inc/powerhouse/commit/605bd5d75))
+- support initial strand without operations ([46698d2ff](https://github.com/powerhouse-inc/powerhouse/commit/46698d2ff))
+- **document-drive:** removed drive id where possible ([adcedc4f0](https://github.com/powerhouse-inc/powerhouse/commit/adcedc4f0))
+
+### 🩹 Fixes
+
+- **document-drive:** added deprecation warnings and release notes ([dbc86d172](https://github.com/powerhouse-inc/powerhouse/commit/dbc86d172))
+- **common:** update storybook story type ([a84550281](https://github.com/powerhouse-inc/powerhouse/commit/a84550281))
+
+### ❤️ Thank You
+
+- acaldas @acaldas
+- ryanwolhuter @ryanwolhuter
+
+## 3.3.0-dev.18 (2025-07-24)
 
 This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
 
-## 4.0.0-staging.4 (2025-07-22)
+## 3.3.0-dev.17 (2025-07-23)
 
 ### 🩹 Fixes
 
@@ -39,11 +178,11 @@ This was a version bump only for @powerhousedao/switchboard to align it with oth
 
 - Callme-T
 
-## 4.0.0-staging.3 (2025-07-17)
+## 3.3.0-dev.16 (2025-07-22)
 
 This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
 
-## 4.0.0-staging.2 (2025-07-17)
+## 3.3.0-dev.15 (2025-07-17)
 
 ### 🩹 Fixes
 
@@ -51,11 +190,7 @@ This was a version bump only for @powerhousedao/switchboard to align it with oth
 
 ### ❤️ Thank You
 
-- acaldas @acaldas
-
-## 4.0.0-staging.1 (2025-07-17)
-
-This was a version bump only for @powerhousedao/switchboard to align it with other projects, there were no code changes.
+- acaldas
 
 ## 3.3.0-dev.14 (2025-07-17)
 

package/README.md

@@ -0,0 +1,218 @@
+# Switchboard
+
+A powerful document-driven server that provides a unified API for managing and serving document models, drives, and reactors in the Powerhouse ecosystem.
+
+## 🚀 Features
+
+- **Document Model Management**: Serve and manage document models with GraphQL API
+- **Document Drive Support**: Handle document drives with filesystem and PostgreSQL storage
+- **Reactor Integration**: Built-in support for Powerhouse reactors
+- **Flexible Storage**: Support for filesystem, PostgreSQL, and Redis caching
+- **Docker Ready**: Containerized deployment with comprehensive environment configuration
+- **Authentication**: Configurable authentication with guest, user, and admin roles
+- **HTTPS Support**: Built-in HTTPS server with custom certificates
+- **Profiling**: Integration with Pyroscope for performance monitoring
+- **Error Tracking**: Sentry integration for error monitoring and reporting
+
+## 📦 Installation
+
+### Prerequisites
+
+- Node.js 22+
+- pnpm (recommended) or npm
+- Redis (optional, for caching)
+- PostgreSQL (optional, for persistent storage)
+
+### Local Development
+
+```bash
+# Clone the repository
+git clone https://github.com/powerhouse-inc/powerhouse.git
+cd powerhouse
+
+# Install dependencies
+pnpm install
+
+# Build the switchboard
+pnpm --filter @powerhousedao/switchboard build
+
+# Start in development mode
+pnpm --filter @powerhousedao/switchboard dev
+```
+
+### Global Installation
+
+```bash
+# Install globally
+npm install -g @powerhousedao/switchboard
+
+# Or using pnpm
+pnpm add -g @powerhousedao/switchboard
+```
+
+## 🏃‍♂️ Quick Start
+
+## ⚙️ Configuration
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `PORT` | Server port | `4001` |
+| `DATABASE_URL` | Database connection string | `./.ph/drive-storage` |
+| `REDIS_URL` | Redis connection URL | - |
+| `REDIS_TLS_URL` | Redis TLS connection URL | - |
+| `SENTRY_DSN` | Sentry DSN for error tracking | - |
+| `SENTRY_ENV` | Sentry environment | - |
+| `PYROSCOPE_SERVER_ADDRESS` | Pyroscope server address | - |
+
+### Authentication Configuration
+
+```typescript
+const options = {
+  auth: {
+    enabled: true,
+    guests: ['0x123', '0x456'],
+    users: ['0x789', '0xabc'],
+    admins: ['0xdef', '0xghi']
+  }
+};
+```
+
+### Storage Options
+
+Switchboard supports multiple storage backends:
+
+- **Filesystem**: Local file-based storage (default)
+- **PostgreSQL**: Persistent database storage
+- **Redis**: Caching layer (optional)
+
+## 🐳 Docker Deployment
+
+### Using Docker Compose
+
+```yaml
+version: '3.8'
+services:
+  switchboard:
+    image: powerhouse/switchboard:latest
+    ports:
+      - "4001:4001"
+    environment:
+      - PORT=4001
+      - DATABASE_URL=postgresql://user:pass@db:5432/switchboard
+      - REDIS_URL=redis://redis:6379
+    depends_on:
+      - db
+      - redis
+
+  db:
+    image: postgres:15
+    environment:
+      POSTGRES_DB: switchboard
+      POSTGRES_USER: user
+      POSTGRES_PASSWORD: pass
+
+  redis:
+    image: redis:7-alpine
+```
+
+### Environment Variables for Docker
+
+```bash
+# Database
+PH_SWITCHBOARD_DATABASE_URL="postgresql://user:pass@db:5432/switchboard"
+PH_SWITCHBOARD_REDIS_URL="redis://redis:6379"
+
+# Authentication
+PH_SWITCHBOARD_AUTH_ENABLED=true
+PH_SWITCHBOARD_ADMINS_LIST="0x123,0x456"
+PH_SWITCHBOARD_USERS_LIST="0x789,0xabc"
+PH_SWITCHBOARD_GUESTS_LIST="0xdef,0xghi"
+
+# Packages
+PH_PACKAGES="package1,package2,package3"
+```
+
+## 🔧 Development
+
+### Project Structure
+
+```
+src/
+├── index.ts          # Main entry point
+├── server.ts         # Server implementation
+├── config.ts         # Configuration management
+├── types.ts          # TypeScript type definitions
+├── utils.ts          # Utility functions
+├── profiler.ts       # Profiling integration
+├── install-packages.ts # Package installation
+└── clients/          # External client integrations
+    └── redis.ts      # Redis client
+```
+
+### Available Scripts
+
+```bash
+# Build the project
+pnpm build
+
+# Start in development mode
+pnpm dev
+
+# Start production server
+pnpm start
+
+# Lint code
+pnpm lint
+
+# Clean build artifacts
+pnpm clean
+```
+
+### Adding New Features
+
+1. **Document Models**: Add new document model modules to the reactor builder
+2. **Storage Backends**: Implement new storage adapters
+3. **Authentication**: Extend authentication logic
+4. **API Endpoints**: Add new GraphQL resolvers
+
+## 📚 API Reference
+
+### GraphQL Endpoints
+
+Switchboard exposes a GraphQL API for document operations:
+
+- **Document Models**: Query and mutate document models
+- **Document Drives**: Manage document drives
+- **Reactor Operations**: Execute reactor operations
+
+### REST Endpoints
+
+- `GET /health` - Health check endpoint
+- `POST /graphql` - GraphQL endpoint
+- `GET /graphql` - GraphQL playground (development)
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+This project is licensed under the ISC License - see the [LICENSE](LICENSE) file for details.
+
+## 🆘 Support
+
+- **Documentation**: [Powerhouse Docs](https://docs.powerhouse.com)
+- **Issues**: [GitHub Issues](https://github.com/powerhouse-inc/powerhouse/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/powerhouse-inc/powerhouse/discussions)
+
+## 🔗 Related Projects
+
+- [@powerhousedao/reactor-api](https://github.com/powerhouse-inc/powerhouse/tree/main/packages/reactor-api) - Reactor API package
+- [@powerhousedao/document-drive](https://github.com/powerhouse-inc/powerhouse/tree/main/packages/document-drive) - Document drive management
+- [@powerhousedao/document-model](https://github.com/powerhouse-inc/powerhouse/tree/main/packages/document-model) - Document model system