@terreno/mcp 57.1.0 → 57.3.0

package/src/docs/versioned/0.27.0/reference/components/README.mdx

@@ -1,65 +0,0 @@
----
-title: UI components
-description: Generated reference pages for @terreno/ui components with live demo embeds.
-slug: /reference/components
----
-
-# UI components
-
-These pages are generated from `demo/ui-types-documentation.json` and `demo/story-config/*.config.tsx` at site build time. Each page embeds the live component demo.
-
-- [Accordion](./accordion)
-- [AddressField](./addressfield)
-- [AI Suggestion Box](./ai-suggestion-box)
-- [Avatar](./avatar)
-- [Badge](./badge)
-- [Banner](./banner)
-- [Boolean field](./boolean-field)
-- [Box](./box)
-- [Button](./button)
-- [Card](./card)
-- [CheckBox](./checkbox)
-- [ConsentFormScreen](./consentformscreen)
-- [Custom Select Field](./custom-select-field)
-- [DataTable](./datatable)
-- [Date & Time field](./date-time-field)
-- [Email field](./email-field)
-- [Emoji selector](./emoji-selector)
-- [Field](./field)
-- [Height field](./height-field)
-- [Icon](./icon)
-- [IconButton](./iconbutton)
-- [Inner modal content](./inner-modal-content)
-- [Markdown editor field](./markdown-editor-field)
-- [MarkdownView](./markdownview)
-- [Multiselect Field](./multiselect-field)
-- [Number field](./number-field)
-- [Page](./page)
-- [Pagination](./pagination)
-- [Password field](./password-field)
-- [Phone number field](./phone-number-field)
-- [Radio field](./radio-field)
-- [SectionDivider](./sectiondivider)
-- [Segmented control](./segmented-control)
-- [Select field](./select-field)
-- [SelectBadge](./selectbadge)
-- [Side drawer](./side-drawer)
-- [Sidebar navigation (non-expo)](./sidebar-navigation-non-expo)
-- [Signature field](./signature-field)
-- [Slider](./slider)
-- [Spinner](./spinner)
-- [Table](./table)
-- [Table badge](./table-badge)
-- [Table boolean](./table-boolean)
-- [Table date](./table-date)
-- [Table icon button](./table-icon-button)
-- [Table number](./table-number)
-- [Table Text](./table-text)
-- [Table title](./table-title)
-- [Tap to edit](./tap-to-edit)
-- [Text area](./text-area)
-- [Text field](./text-field)
-- [Theme](./theme)
-- [Toast](./toast)
-- [Tooltip](./tooltip)
-- [UserInactivity](./userinactivity)

package/src/docs/versioned/0.27.0/reference/components/badge.mdx

@@ -1,38 +0,0 @@
----
-title: "Badge"
-description: "Badge is a label that indicates status or importance. Badges should provide quick recognition.\\n"
-sidebar_label: "Badge"
-slug: /reference/components/badge
----
-
-import ComponentDemo from '@site/src/components/ComponentDemo';
-
-# Badge
-
-Badge is a label that indicates status or importance. Badges should provide quick recognition.\n
-
-**Package:** `@terreno/ui`  
-**Categories:** Component  
-**Props interface:** `BadgeProps`  
-**Story source:** [`demo/stories/Badge.stories.tsx`](https://github.com/flourishhealth/terreno/blob/master/demo/stories/Badge.stories.tsx)
-
-## Live demo
-
-<ComponentDemo name="Badge" />
-
-## Props
-
-| Prop | Type | Required | Description |
-| --- | --- | --- | --- |
-| `customBackgroundColor` | `string` |  | When status is "custom", determines the badge's background color. |
-| `customBorderColor` | `string` |  | When status is "custom", determines the badge's border color. |
-| `customIconColor` | `keyof TextTheme` |  | When status is "custom", determines the badge's icon color |
-| `customIconName` | `IconName` |  | When status is "custom", determines the badge's icon |
-| `customTextColor` | `string` |  | When status is "custom", determines the badge's text color. |
-| `iconName` | `IconName` |  | The name of the icon to display in the badge. |
-| `maxValue` | `number` |  | The maximum value to display. Used for "numberOnly" variant to display "$\{maxValue\}+" when value is greater than max. |
-| `secondary` | `boolean` |  | If true, the badge will have a secondary style. |
-| `status` | `union` |  | The status of the badge. Determines its color and appearance. |
-| `testID` | `string` |  | Root test id for the primary interactive element or container. |
-| `value` | `union` |  | The text or number to display inside the badge. |
-| `variant` | `union` |  | The variant of the badge. Determines if it displays an icon or number only. |

package/src/docs/versioned/0.27.0/reference/components/card.mdx

@@ -1,26 +0,0 @@
----
-title: "Card"
-description: "A card serves as a surface for information. It helps organize and highlight information while providing visual hierarchy."
-sidebar_label: "Card"
-slug: /reference/components/card
----
-
-import ComponentDemo from '@site/src/components/ComponentDemo';
-
-# Card
-
-A card serves as a surface for information. It helps organize and highlight information while providing visual hierarchy. This design system has two kinds of cards: Display and Container.
-
-**Package:** `@terreno/ui`  
-**Categories:** Component  
-**Props interface:** `CardProps`  
-**Story source:** [`demo/stories/Card.stories.tsx`](https://github.com/flourishhealth/terreno/blob/master/demo/stories/Card.stories.tsx)
-
-## Live demo
-
-<ComponentDemo name="Card" />
-
-## Props
-
-_No documented props were extracted from TypeDoc._
-

package/src/docs/versioned/0.27.0/reference/components/custom-select-field.mdx

@@ -1,37 +0,0 @@
----
-title: "Custom Select Field"
-description: "Displays a list of options using the browser’s native select and includes a custom option that renders a text field when selected and allows user to input value not included in predefined options."
-sidebar_label: "Custom Select Field"
-slug: /reference/components/custom-select-field
----
-
-import ComponentDemo from '@site/src/components/ComponentDemo';
-
-# Custom Select Field
-
-Displays a list of options using the browser’s native select and includes a custom option that renders a text field when selected and allows user to input value not included in predefined options.
-
-**Package:** `@terreno/ui`  
-**Categories:** Component  
-**Props interface:** `CustomSelectFieldProps`  
-**Story source:** [`demo/stories/CustomSelectField.stories.tsx`](https://github.com/flourishhealth/terreno/blob/master/demo/stories/CustomSelectField.stories.tsx)
-
-## Live demo
-
-<ComponentDemo name="Custom Select Field" />
-
-## Props
-
-| Prop | Type | Required | Description |
-| --- | --- | --- | --- |
-| `onChange` | `reflection` | Yes | The function to call when the custom select field value changes. |
-| `options` | `array` | Yes | The options available for selection in the select field. Each option should have a label and a value. |
-| `value` | `union` | Yes | The current value of the custom select field. |
-| `disabled` | `boolean` |  | If true, the select field will be disabled. |
-| `errorText` | `string` |  | The error text to display if there is an error. |
-| `helperText` | `string` |  | The helper text to display below the select field. |
-| `placeholder` | `string` |  | The placeholder text to display when no option is selected. |
-| `searchable` | `boolean` |  | When true, options can be filtered as the user types. See  |
-| `testID` | `string` |  | Root test id for the primary interactive element or container. |
-| `testIDs` | `FieldTestIDs` |  |  |
-| `title` | `string` |  | The title of the custom select field. |

package/src/docs/versioned/0.27.0/reference/environment-variables.md

@@ -1,386 +0,0 @@
-# Environment Variables Reference
-
-Comprehensive guide to environment variables used across Terreno packages and example applications.
-
-## Table of Contents
-
-- [@terreno/api (Backend)](#terrenoapi-backend)
-- [@terreno/rtk (Frontend State)](#terrenortk-frontend-state)
-- [@terreno/ui (Components)](#terrenoui-components)
-- [Example Backend](#example-backend)
-- [Example Frontend](#example-frontend)
-
----
-
-## @terreno/api (Backend)
-
-Environment variables used by the `@terreno/api` package.
-
-### Authentication
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `AUTH_PROVIDER` | ❌ | `jwt` | Authentication provider: `"jwt"` or `"better-auth"` |
-| `TOKEN_SECRET` | ✅ (if JWT) | - | Secret key for signing JWT access tokens |
-| `TOKEN_ISSUER` | ✅ (if JWT) | - | JWT issuer claim (e.g., `your-app.com`) |
-| `REFRESH_TOKEN_SECRET` | ✅ (if JWT) | - | Secret key for signing refresh tokens |
-| `SESSION_SECRET` | ✅ (if JWT) | - | Express session secret |
-| `TOKEN_EXPIRES_IN` | ❌ | `15m` | Access token expiration (e.g., `1h`, `30m`) |
-| `REFRESH_TOKEN_EXPIRES_IN` | ❌ | `30d` | Refresh token expiration (e.g., `7d`, `90d`) |
-| `SIGNUP_DISABLED` | ❌ | `false` | Disable user registration (invite-only mode) |
-
-### Better Auth (Optional)
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `BETTER_AUTH_SECRET` | ✅ (if Better Auth) | - | Secret key for Better Auth session encryption |
-| `BETTER_AUTH_URL` | ✅ (if Better Auth) | - | Base URL for Better Auth server (e.g., `https://api.example.com`) |
-| `GOOGLE_CLIENT_ID` | ❌ | - | Google OAuth client ID |
-| `GOOGLE_CLIENT_SECRET` | ❌ | - | Google OAuth client secret |
-| `APPLE_CLIENT_ID` | ❌ | - | Apple Sign In service ID |
-| `APPLE_CLIENT_SECRET` | ❌ | - | Apple Sign In private key |
-
-### GitHub OAuth (Optional)
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `GITHUB_CLIENT_ID` | ❌ | - | GitHub OAuth application client ID |
-| `GITHUB_CLIENT_SECRET` | ❌ | - | GitHub OAuth application client secret |
-| `GITHUB_CALLBACK_URL` | ❌ | - | OAuth callback URL (e.g., `https://api.example.com/auth/github/callback`) |
-
-### Server Configuration
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `PORT` | ❌ | `3000` | HTTP server port |
-| `NODE_ENV` | ❌ | `development` | Node environment (`development`, `production`, `test`) |
-| `MONGO_URI` | ❌ | `mongodb://localhost:27017` | MongoDB connection string |
-| `ENABLE_SWAGGER` | ❌ | `false` | Enable Swagger UI at `/swagger` endpoint |
-
-### Logging & Monitoring
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `SENTRY_DSN` | ❌ | - | Sentry DSN for error tracking |
-| `USE_SENTRY_LOGGING` | ❌ | `false` | Send logs to Sentry |
-| `LOG_REQUESTS` | ❌ | `false` | Log all HTTP requests |
-| `LOG_SLOW_REQUESTS` | ❌ | `false` | Log requests exceeding threshold |
-| `SLOW_REQUEST_THRESHOLD_MS` | ❌ | `5000` | Milliseconds to consider a request "slow" |
-| `SLOW_DB_QUERY_THRESHOLD_MS` | ❌ | `100` | Milliseconds to consider a DB query "slow" |
-
-### Webhooks & Notifications (Optional)
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `SLACK_WEBHOOKS` | ❌ | - | JSON object mapping names to Slack webhook URLs<br/>Example: `{"default": "https://hooks.slack.com/..."}` |
-| `GOOGLE_CHAT_WEBHOOKS` | ❌ | - | JSON object mapping names to Google Chat webhook URLs<br/>Example: `{"default": "https://chat.googleapis.com/..."}` |
-| `ZOOM_WEBHOOK` | ❌ | - | Zoom webhook URL for notifications |
-
-### Google Cloud Platform (Optional)
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `GCP_PROJECT` | ❌ | - | Google Cloud project ID |
-| `GCP_LOCATION` | ❌ | - | GCP region (e.g., `us-central1`) |
-| `GCP_SERVICE_ACCOUNT_EMAIL` | ❌ | - | Service account email for authentication |
-| `GCP_TASKS_NOTIFICATIONS_QUEUE` | ❌ | - | Cloud Tasks queue name for notifications |
-| `GCP_TASK_PROCESSOR_QUEUE` | ❌ | - | Cloud Tasks queue name for background tasks |
-
-### Caching & Performance
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `VALKEY_URL` | ❌ | - | Redis/Valkey connection URL (e.g., `redis://localhost:6379`) |
-
-### Other APIs
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `GEMINI_API_KEY` | ❌ | - | Google Gemini API key for AI features |
-
-### Example .env File
-
-``````bash
-# Authentication Provider
-AUTH_PROVIDER=jwt  # or "better-auth"
-
-# Required for JWT authentication
-TOKEN_SECRET=your-secret-key-change-this-in-production
-TOKEN_ISSUER=your-app.com
-REFRESH_TOKEN_SECRET=your-refresh-secret-change-this-too
-SESSION_SECRET=your-session-secret-change-this-also
-
-# Required for Better Auth (if AUTH_PROVIDER=better-auth)
-# BETTER_AUTH_SECRET=your-better-auth-secret-min-32-chars
-# BETTER_AUTH_URL=http://localhost:4000
-
-# Optional - Social OAuth (Better Auth)
-# GOOGLE_CLIENT_ID=your-google-client-id
-# GOOGLE_CLIENT_SECRET=your-google-client-secret
-# GITHUB_CLIENT_ID=your-github-client-id
-# GITHUB_CLIENT_SECRET=your-github-client-secret
-
-# Database
-MONGO_URI=mongodb://localhost:27017/your-app
-
-# Optional - Common in development
-PORT=3000
-NODE_ENV=development
-ENABLE_SWAGGER=true
-LOG_REQUESTS=true
-
-# Optional - Production monitoring
-SENTRY_DSN=https://your-sentry-dsn@sentry.io/project-id
-USE_SENTRY_LOGGING=true
-``````
-
----
-
-## @terreno/rtk (Frontend State)
-
-Environment variables used by the `@terreno/rtk` package and frontend applications.
-
-### Base URL Configuration
-
-The base URL is resolved in priority order:
-
-1. `Constants.expoConfig?.extra?.BASE_URL` (production/staging builds)
-2. `process.env.EXPO_PUBLIC_API_URL` (development web)
-3. `Constants.expoConfig?.hostUri` + the dev API port (dev simulator/device)
-4. `http://localhost:<dev API port>` (fallback)
-
-The dev API port defaults to `4000` and is overridable per app via `EXPO_PUBLIC_DEV_API_PORT`
-or `expoConfig.extra.DEV_API_PORT` (for example `3000` or `9000`).
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `EXPO_PUBLIC_API_URL` | ❌ | Auto-detected | Backend API base URL<br/>Web: `http://localhost:4000`<br/>Simulator: Auto-detected via `hostUri`<br/>Device: Use your computer's local IP |
-| `EXPO_PUBLIC_DEV_API_PORT` | ❌ | 4000 | Local dev API port for host/localhost resolution (also settable via `extra.DEV_API_PORT`) |
-
-### Debug Flags
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `AUTH_DEBUG` | ❌ | `false` | Enable authentication debug logging |
-| `WEBSOCKETS_DEBUG` | ❌ | `false` | Enable WebSocket debug logging |
-
-### Example app.json Configuration
-
-``````json
-{
-  "expo": {
-    "extra": {
-      "BASE_URL": "https://api.example.com",
-      "AUTH_DEBUG": "false",
-      "WEBSOCKETS_DEBUG": "false"
-    }
-  }
-}
-``````
-
-### Example .env for Web Development
-
-``````bash
-# Backend API URL
-EXPO_PUBLIC_API_URL=http://localhost:4000
-``````
-
----
-
-## @terreno/ui (Components)
-
-The `@terreno/ui` package **does not require environment variables**. All configuration is done at runtime via the `TerrenoProvider` component.
-
-### Runtime Configuration
-
-``````typescript
-import {TerrenoProvider} from "@terreno/ui";
-
-<TerrenoProvider
-  initialTheme={{
-    primitives: {
-      primary500: "#0066CC",
-      accent500: "#FF6B35",
-    }
-  }}
->
-  <App />
-</TerrenoProvider>
-``````
-
----
-
-## Example Backend
-
-Environment variables specific to the example backend application (not part of @terreno/api).
-
-### Application Configuration
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `APP_ENV` | ❌ | `development` | Application environment (`development`, `staging`, `production`) |
-| `BACKEND_SERVICE` | ❌ | `all` | Service type to run: `api`, `websockets`, `tasks`, or `all` |
-| `API_URL` | ❌ | - | API service URL (for microservice architecture) |
-| `TASKS_URL` | ❌ | - | Tasks service URL (for microservice architecture) |
-| `FLOURISH_SERVICE` | ❌ | `flourish-backend` | Service name for OpenTelemetry tracing |
-
-### WebSockets
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `WEBSOCKET_PORT` | ❌ | Same as `PORT` | WebSocket server port (if separate from HTTP) |
-| `FRONTEND_URL` | ❌ | Auto-detected | Frontend URL for CORS (e.g., `http://localhost:8082`) |
-
-### Pull Request Environments
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `PR_NUMBER` | ❌ | - | Pull request number (set by CI/CD) |
-| `PR_SERVICE_URL` | ❌ | - | Cloud Run service URL base for PR environments |
-
-### Performance Monitoring
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `MEMORY_SAMPLE_INTERVAL_MS` | ❌ | `60000` | Interval for memory usage sampling |
-| `TRACE_SAMPLING_RATE` | ❌ | `0.1` | OpenTelemetry trace sampling rate (0.0-1.0) |
-
-### Testing
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `TEST_MONGO_URI` | ❌ | `mongodb://localhost:27017/test` | MongoDB URI for tests |
-| `CRON_SECRET_KEY` | ❌ | - | Secret key for testing cron endpoints |
-
-### Configuration Model System
-
-The example backend uses a **Configuration model** with a priority system:
-
-**Priority (highest to lowest)**:
-1. Runtime override via `Configuration.set()`
-2. Database cache (persisted values)
-3. Environment variable
-4. Default value
-
-``````typescript
-// Get configuration value
-const pageSize = await Configuration.get("DEFAULT_PAGE_SIZE"); // Returns 20
-
-// Set configuration value (persists to database)
-await Configuration.set("DEFAULT_PAGE_SIZE", 50);
-
-// Register new configuration
-Configuration.register("FEATURE_FLAG", {
-  defaultValue: false,
-  envVar: "FEATURE_FLAG",
-  description: "Enable new feature",
-  type: "boolean",
-});
-``````
-
-See [Configuration System](../explanation/configuration-system.md) for details.
-
----
-
-## Example Frontend
-
-Environment variables specific to the example frontend application.
-
-### SDK Generation
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `OPENAPI_URL` | ❌ | `http://localhost:4000/openapi.json` | Backend OpenAPI spec URL for SDK generation |
-
-Used by `bun run sdk` to fetch the OpenAPI specification and generate RTK Query hooks.
-
-### Development
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `EXPO_PUBLIC_API_URL` | ❌ | Auto-detected | Backend API URL (see [@terreno/rtk](#terrenortk-frontend-state)) |
-
-### Example .env File
-
-``````bash
-# Backend API (optional - auto-detected if not set)
-EXPO_PUBLIC_API_URL=http://localhost:4000
-
-# SDK generation (optional)
-OPENAPI_URL=http://localhost:4000/openapi.json
-``````
-
----
-
-## Best Practices
-
-### Security
-
-1. **Never commit `.env` files** - Add to `.gitignore`
-2. **Use strong secrets** - Generate with `openssl rand -base64 32`
-3. **Rotate secrets regularly** - Especially `TOKEN_SECRET` and `REFRESH_TOKEN_SECRET`
-4. **Different secrets per environment** - Don't reuse production secrets in development
-
-### Development
-
-1. **Use `.env.example`** - Check into version control with placeholder values
-2. **Document all variables** - Include description and default values
-3. **Validate required variables** - Fail fast if missing critical config
-4. **Auto-detect when possible** - Like `@terreno/rtk` does for `BASE_URL`
-
-### Production
-
-1. **Use environment variables** - Not hardcoded values or `.env` files
-2. **Set via platform** - Railway, Heroku, Cloud Run, etc.
-3. **Enable monitoring** - Set `SENTRY_DSN` and `USE_SENTRY_LOGGING`
-4. **Reduce logging** - Set `LOG_REQUESTS=false` to reduce noise
-
----
-
-## Troubleshooting
-
-### "TOKEN_SECRET is not set"
-
-**Problem**: Required authentication variables missing.
-
-**Solution**: 
-```bash
-cp .env.example .env
-# Edit .env and set all required variables
-```
-
-### "Cannot connect to MongoDB"
-
-**Problem**: `MONGO_URI` incorrect or MongoDB not running.
-
-**Solutions**:
-- Ensure MongoDB is running: `docker run -d -p 27017:27017 mongo`
-- Check `MONGO_URI` in `.env`
-- Test connection: `mongosh mongodb://localhost:27017`
-
-### "Network request failed" (Frontend)
-
-**Problem**: Frontend can't reach backend.
-
-**Solutions**:
-- Ensure backend is running
-- Check `EXPO_PUBLIC_API_URL` matches backend port
-- For physical devices: Use your computer's local IP, not `localhost`
-- Verify CORS settings allow frontend origin
-
-### "Invalid token"
-
-**Problem**: Token secrets mismatch between frontend/backend.
-
-**Solution**: Ensure `TOKEN_SECRET` and `REFRESH_TOKEN_SECRET` are identical across deployments if using shared authentication.
-
----
-
-## Related Documentation
-
-- [Getting Started Tutorial](../tutorials/getting-started.md)
-- [@terreno/api Reference](./api.md)
-- [@terreno/rtk Reference](./rtk.md)
-- [Configuration System](../explanation/configuration-system.md)
-- [Example Backend README](../../example-backend/README.md)
-- [Example Frontend README](../../example-frontend/README.md)