@botonic/nx-plugin 2.23.0

package/CHANGELOG.md

@@ -0,0 +1,420 @@
+## 2.23.0 (2026-03-23)
+
+### 🚀 Features
+
+- **nx-plugin:** add action and webview generators [BLT-2253] ([#749](https://github.com/metis-ai/hubtype-product/pull/749))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.22.1 (2026-03-19)
+
+This was a version bump only for @botonic/nx-plugin to align it with other projects, there were no code changes.
+
+## 2.22.0 (2026-03-16)
+
+### 🚀 Features
+
+- webchat to retrieve pusher config from backend ([#742](https://github.com/metis-ai/hubtype-product/pull/742))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.21.0 (2026-03-16)
+
+### 🚀 Features
+
+- **botonic-nx-plugin:** set prod as default serve config and improve first-run UX #BLT-2243 ([#735](https://github.com/metis-ai/hubtype-product/pull/735))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.20.0 (2026-03-13)
+
+### 🚀 Features
+
+- controlling lambda resources in docker ([#727](https://github.com/metis-ai/hubtype-product/pull/727))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.19.0 (2026-03-12)
+
+### 🚀 Features
+
+- serve executor refactored with automatic tunneling and global store credentials per environment, needed to support external collaborators ([#704](https://github.com/metis-ai/hubtype-product/pull/704))
+- **webchat-react:** gateway pattern + lilara unified Storybook #BLT-2210 ([#717](https://github.com/metis-ai/hubtype-product/pull/717))
+- add lilara release tooling and CI workflows #BLT-2209 ([#711](https://github.com/metis-ai/hubtype-product/pull/711))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+- Marc Rabat @vanbasten17
+
+## 2.18.0 (2026-03-04)
+
+### 🚀 Features
+
+- **publishing:** package fixes, lilara rename & token/reset unification #BLT-2205 #BLT-2221 #BLT-2206 ([#701](https://github.com/metis-ai/hubtype-product/pull/701))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.17.0 (2026-03-02)
+
+### 🚀 Features
+
+- **botonic/nx-plugin:** split bot-app migrations into on-demand generators [BLT-2194] ([#695](https://github.com/metis-ai/hubtype-product/pull/695))
+- botonic working with v2 input format ([#660](https://github.com/metis-ai/hubtype-product/pull/660))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+- Marc Rabat @vanbasten17
+
+## 2.16.0 (2026-02-23)
+
+### 🚀 Features
+
+- **webchat-trigger:** Figma design tokens, animations, and theme overrides ([#679](https://github.com/metis-ai/hubtype-product/pull/679))
+- **webchat:** lazy loading trigger with optimized bundle splitting ([#614](https://github.com/metis-ai/hubtype-product/pull/614))
+
+### 🩹 Fixes
+
+- **botonic:** css not loading after build #BLT-2195 ([#687](https://github.com/metis-ai/hubtype-product/pull/687))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.15.0 (2026-02-13)
+
+### 🚀 Features
+
+- enable new features for BotonicV2 #BLT-2174 ([#649](https://github.com/metis-ai/hubtype-product/pull/649))
+
+### ❤️ Thank You
+
+- Oriol Raventós @Iru89
+
+## 2.14.0 (2026-02-05)
+
+### 🚀 Features
+
+- **botonic:** add E2E publish flow testing with Verdaccio ([#577](https://github.com/metis-ai/hubtype-product/pull/577))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.13.4 (2026-02-02)
+
+This was a version bump only for @botonic/nx-plugin to align it with other projects, there were no code changes.
+
+## 2.13.3 (2026-01-30)
+
+### 🩹 Fixes
+
+- botonic deps to be bundled within lambda dist, add fake env vars… ([#575](https://github.com/metis-ai/hubtype-product/pull/575))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.13.2 (2026-01-30)
+
+### 🩹 Fixes
+
+- broken styles after publishing packages and use of them along with generator ([#571](https://github.com/metis-ai/hubtype-product/pull/571))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.13.1 (2026-01-30)
+
+This was a version bump only for @botonic/nx-plugin to align it with other projects, there were no code changes.
+
+## 2.13.0 (2026-01-29)
+
+### 🚀 Features
+
+- add generic overlay system for webviews and cover components ([#547](https://github.com/metis-ai/hubtype-product/pull/547))
+
+### 🩹 Fixes
+
+- switch to single bundled CSS file ([#564](https://github.com/metis-ai/hubtype-product/pull/564))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+- Marc Rabat @vanbasten17
+
+## 2.12.0 (2026-01-28)
+
+### 🚀 Features
+
+- enhance post-build script and executor for .env file management ([#560](https://github.com/metis-ai/hubtype-product/pull/560))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.11.5 (2026-01-28)
+
+This was a version bump only for @botonic/nx-plugin to align it with other projects, there were no code changes.
+
+## 2.11.4 (2026-01-28)
+
+This was a version bump only for @botonic/nx-plugin to align it with other projects, there were no code changes.
+
+## 2.11.3 (2026-01-28)
+
+This was a version bump only for @botonic/nx-plugin to align it with other projects, there were no code changes.
+
+## 2.11.2 (2026-01-21)
+
+### 🩹 Fixes
+
+- update package.json path resolution in bot app and preset generators to ensure correct version retrieval ([#539](https://github.com/metis-ai/hubtype-product/pull/539))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.11.1 (2026-01-21)
+
+### 🩹 Fixes
+
+- botonicVersion on bot app generator now uses the current version by default ([#537](https://github.com/metis-ai/hubtype-product/pull/537))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.11.0 (2026-01-21)
+
+### 🚀 Features
+
+- use webview contents hook in botonic webviews package #BLT-2039 ([#510](https://github.com/metis-ai/hubtype-product/pull/510))
+
+### 🩹 Fixes
+
+- dist to not be included in lint processes ([#536](https://github.com/metis-ai/hubtype-product/pull/536))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.10.1 (2026-01-19)
+
+### 🩹 Fixes
+
+- fix outdated optimize dep vite error and each app to have its own cache ([#531](https://github.com/metis-ai/hubtype-product/pull/531))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.10.0 (2026-01-18)
+
+### 🚀 Features
+
+- update nx-plugin project configuration for CommonJS ([#529](https://github.com/metis-ai/hubtype-product/pull/529))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.9.1 (2026-01-17)
+
+### 🩹 Fixes
+
+- Botonic version resolution in generators ([#527](https://github.com/metis-ai/hubtype-product/pull/527))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.9.0 (2026-01-17)
+
+### 🚀 Features
+
+- add esbuild plugin for .js extension handling and update project configuration ([#525](https://github.com/metis-ai/hubtype-product/pull/525))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.8.1 (2026-01-16)
+
+This was a version bump only for @botonic/nx-plugin to align it with other projects, there were no code changes.
+
+## 2.8.0 (2026-01-16)
+
+### 🩹 Fixes
+
+- update Git configuration in workflows to use environment variables for user name and email ([#520](https://github.com/metis-ai/hubtype-product/pull/520))
+- cleanup botonic migrations ([#518](https://github.com/metis-ai/hubtype-product/pull/518))
+- update bot app creation command in generator output ([#516](https://github.com/metis-ai/hubtype-product/pull/516))
+- Update release workflow to use GitHub App token for authentication and streamline PR creation process ([#515](https://github.com/metis-ai/hubtype-product/pull/515))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.7.1 (2026-01-16)
+
+### 🩹 Fixes
+
+- cleanup botonic migrations ([#518](https://github.com/metis-ai/hubtype-product/pull/518))
+- update bot app creation command in generator output ([#516](https://github.com/metis-ai/hubtype-product/pull/516))
+- Update release workflow to use GitHub App token for authentication and streamline PR creation process ([#515](https://github.com/metis-ai/hubtype-product/pull/515))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.7.0 (2026-01-15)
+
+### 🩹 Fixes
+
+- update CI workflow to skip affected targets for release branches ([7cbf270a](https://github.com/metis-ai/hubtype-product/commit/7cbf270a))
+
+### ❤️ Thank You
+
+- David Hidalgo
+
+## 2.6.0 (2025-12-09)
+
+### 🩹 Fixes
+
+- remove '@botonic/plugin-knowledge-bases' from package.json dependencies in bot-app generator ([#485](https://github.com/metis-ai/hubtype-product/pull/485))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.5.0 (2025-12-09)
+
+### 🚀 Features
+
+- refine packageManager options in PresetGeneratorSchema to remove unsupported values ([#482](https://github.com/metis-ai/hubtype-product/pull/482))
+- update GitHub Actions to use RELEASE_PAT for authentication and refine packageManager options in BotAppGeneratorSchema ([#481](https://github.com/metis-ai/hubtype-product/pull/481))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.4.1 (2025-12-08)
+
+### 🩹 Fixes
+
+- enhance botonic release and support backporting ([#474](https://github.com/metis-ai/hubtype-product/pull/474))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.4.0 (2025-12-05)
+
+### 🚀 Features
+
+- **nx-plugin:** fine tunning generators #BLT-2049 ([#468](https://github.com/metis-ai/hubtype-product/pull/468))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.3.3 (2025-12-04)
+
+### 🩹 Fixes
+
+- **nx-plugin:** remove ESM compatibility script and update imports to CommonJS style; adjust package.json and project.json for cleaner configuration ([248b21bd4](https://github.com/metis-ai/hubtype-product/commit/248b21bd4))
+
+### ❤️ Thank You
+
+- David Hidalgo
+
+## 2.3.2 (2025-12-04)
+
+### 🩹 Fixes
+
+- **nx-plugin:** replace direct import of 'prompt' from 'enquirer' with destructured import from 'enquirer' across multiple executors and utility files ([9c240bfc5](https://github.com/metis-ai/hubtype-product/commit/9c240bfc5))
+
+### ❤️ Thank You
+
+- David Hidalgo
+
+## 2.3.1 (2025-12-04)
+
+### 🩹 Fixes
+
+- **nx-plugin:** enhance ESM compatibility by adding .js extensions to imports and JSON config paths ([61277d622](https://github.com/metis-ai/hubtype-product/commit/61277d622))
+
+### ❤️ Thank You
+
+- David Hidalgo
+
+## 2.3.0 (2025-12-04)
+
+### 🚀 Features
+
+- **nx-plugin:** add build and fix-esm-paths commands to project.json; implement script for ESM compatibility ([7e8843b48](https://github.com/metis-ai/hubtype-product/commit/7e8843b48))
+
+### ❤️ Thank You
+
+- David Hidalgo
+
+## 2.2.1 (2025-12-04)
+
+This was a version bump only for @botonic/nx-plugin to align it with other projects, there were no code changes.
+
+## 2.2.0 (2025-12-04)
+
+### 🚀 Features
+
+- update bot app generator ([#455](https://github.com/metis-ai/hubtype-product/pull/455))
+- add custom tool and bot action ([#452](https://github.com/metis-ai/hubtype-product/pull/452))
+- improved serve-dev proposal, all-in-one terminal ([#448](https://github.com/metis-ai/hubtype-product/pull/448))
+- add RELEASE.json for versioning and update logic in release process ([#440](https://github.com/metis-ai/hubtype-product/pull/440))
+- enhance bot app generator with customizable options and global render function ([#439](https://github.com/metis-ai/hubtype-product/pull/439))
+- fine tuning botonic release #BLT-2010 ([#428](https://github.com/metis-ai/hubtype-product/pull/428))
+
+### 🩹 Fixes
+
+- preset generator and release tag creation on local fixed ([#461](https://github.com/metis-ai/hubtype-product/pull/461))
+- botonic release ([#445](https://github.com/metis-ai/hubtype-product/pull/445))
+- botonic v2 release ([#441](https://github.com/metis-ai/hubtype-product/pull/441))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+- Marc Rabat @vanbasten17
+- Oriol Raventós @Iru89
+
+## 2.1.0 (2025-12-02)
+
+### 🚀 Features
+
+- add RELEASE.json for versioning and update logic in release process ([#440](https://github.com/metis-ai/hubtype-product/pull/440))
+- enhance bot app generator with customizable options and global render function ([#439](https://github.com/metis-ai/hubtype-product/pull/439))
+- fine tuning botonic release #BLT-2010 ([#428](https://github.com/metis-ai/hubtype-product/pull/428))
+
+### 🩹 Fixes
+
+- botonic release ([#445](https://github.com/metis-ai/hubtype-product/pull/445))
+- botonic v2 release ([#441](https://github.com/metis-ai/hubtype-product/pull/441))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.0.1-alpha.0 (2025-11-27)
+
+This was a version bump only for @botonic/nx-plugin to align it with other projects, there were no code changes.

package/README.md

@@ -0,0 +1,279 @@
+# @botonic/nx-plugin
+
+An Nx plugin for Botonic projects that provides generators and migration tools.
+
+## Features
+
+- **Bot App Generator**: Creates modern Botonic bot applications with current best practices
+- **Migration Tools**: Automatically modernizes legacy Botonic bots to use current patterns
+- **Local runtime (no Docker)**: Run and test against the real backend using an external Lambda URL (e.g. ngrok) — see [External developer workflow](docs/external-developer-local-runtime-workflow.md)
+
+## Installation
+
+```bash
+pnpm install@botonic/nx-plugin
+```
+
+## Generators
+
+### Bot App Generator
+
+Creates a new Botonic bot application with modern patterns:
+
+```bash
+nx g @botonic/nx-plugin:bot-app my-bot
+```
+
+#### What it creates:
+
+- **Modern Actions**: Async functions using `BotContext` instead of React class components
+- **React 18 Webchat**: Uses `@botonic/webchat` with `createRoot` and `StrictMode`
+- **Current Dependencies**: Uses modern Botonic packages and avoids legacy packages
+- **Custom Messages Structure**: Empty structure ready for your custom components
+
+## Migrations
+
+### Modernize Bot Actions
+
+This migration automatically updates legacy Botonic bots to use current patterns and technologies.
+
+#### Running the Migration
+
+**Interactive project selection (recommended):**
+
+```bash
+nx migrate @botonic/nx-plugin
+```
+
+When you have multiple bot projects, the migration will show an interactive prompt:
+
+```
+📦 Found 3 Botonic bot project(s)
+🎯 Select which projects to modernize:
+
+❯ ◯ customer-support-bot (needs migration)
+  ◯ sales-bot (already modern)
+  ◯ legacy-bot (needs migration)
+```
+
+Use arrow keys to navigate, spacebar to select/unselect, and Enter to confirm.
+
+**Migrate all bot projects (non-interactive):**
+
+```bash
+# For single project workspaces or automated scripts
+nx migrate @botonic/nx-plugin --run-migrations
+```
+
+**Migrate specific projects (command line):**
+
+```bash
+# Using generator with specific projects
+nx g @botonic/nx-plugin:modernize-bot-actions --projects=my-bot,another-bot
+
+# Or using migration file directly
+nx migrate @botonic/nx-plugin --run-migrations=migration.json
+```
+
+**Project naming:**
+
+- You can use project names with or without the `apps/` prefix
+- `my-bot` and `apps/my-bot` are equivalent
+- Invalid projects will be rejected with helpful error messages
+
+**Examples:**
+
+```bash
+# Migrate a single project
+nx g @botonic/nx-plugin:modernize-bot-actions --projects=customer-support-bot
+
+# Migrate multiple specific projects
+nx g @botonic/nx-plugin:modernize-bot-actions --projects=bot-1,bot-2,bot-3
+
+# Interactive selection (when multiple projects exist)
+nx migrate @botonic/nx-plugin
+```
+
+#### Automatic Migration on Upgrade
+
+The migration will automatically run when you upgrade the package:
+
+```bash
+# Upgrade will prompt for pending migrations
+pnpm install@botonic/nx-plugin@latest
+nx migrate @botonic/nx-plugin --run-migrations
+```
+
+#### What migrations do:
+
+Migrations automatically update your Botonic projects to use current patterns, dependencies, and best practices. Each migration:
+
+1. **Code Modernization**:
+   - Updates code patterns to use current Botonic APIs
+   - Transforms legacy implementations to modern equivalents
+   - Maintains existing functionality while improving structure
+
+2. **Dependency Management**:
+   - Updates Botonic packages to target versions
+   - Ensures compatibility across all dependencies
+   - Removes deprecated packages when appropriate
+
+3. **Configuration Updates**:
+   - Updates project configuration files
+   - Applies current best practices and conventions
+   - Maintains backward compatibility where possible
+
+4. **Structure Improvements**:
+   - Creates missing files or folders as needed
+   - Updates file organization to current standards
+   - Ensures projects follow recommended patterns
+
+#### Project Selection Benefits
+
+- **🎯 Interactive Selection**: Visual checkboxes with clear status indicators
+- **📊 Smart Detection**: Automatically detects which projects need migration vs already modern
+- **🧪 Test Gradually**: Migrate one bot at a time to test changes
+- **⚡ Selective Updates**: Only modernize bots that are ready
+- **🚫 Avoid Conflicts**: Skip bots with ongoing development
+- **🔧 Better Control**: Choose which projects to update in each run
+- **💡 Clear Status**: See "(needs migration)" or "(already modern)" labels
+
+#### Example Transformation
+
+**Before (legacy React class component):**
+
+```typescript
+import React from 'react'
+import { Text } from '@botonic/react'
+
+export class Welcome extends React.Component {
+  render() {
+    return (
+      <Text>
+        Hello! I'm your bot 🤖
+        <br />
+        Welcome to Botonic!
+      </Text>
+    )
+  }
+}
+```
+
+**After (modern async function):**
+
+```typescript
+import { BotContext } from '@botonic/core'
+import { MessageAction } from '@botonic/shared'
+
+export async function Welcome({ sendMessage }: BotContext) {
+  await sendMessage([
+    {
+      type: 'text',
+      data: { text: "Hello! I'm your bot 🤖\nWelcome to Botonic!" },
+      action: MessageAction.SentByBot,
+    },
+  ])
+
+  return {
+    status: 200,
+    response: 'OK',
+  }
+}
+```
+
+#### Reviewing Changes
+
+After running the migration, review what changed:
+
+```bash
+git diff
+```
+
+The migration is **idempotent** - it's safe to run multiple times and will only transform files that need updating.
+
+#### Manual Testing
+
+Run the included test to verify migration functionality:
+
+```bash
+# From the plugin directory
+pnpm run test:migration
+```
+
+This test creates sample legacy bots and verifies the migration transforms them correctly, including project selection functionality.
+
+#### Version Management
+
+The migration is tied to the package version. When you upgrade `@botonic/nx-plugin`, Nx will automatically prompt you to run any new migrations:
+
+```bash
+# Check for available migrations
+nx migrate @botonic/nx-plugin
+
+# Run pending migrations
+nx migrate --run-migrations
+```
+
+## Development
+
+### Building
+
+```bash
+nx build nx-plugin
+```
+
+### Testing
+
+```bash
+nx test nx-plugin
+```
+
+### Manual Migration Testing
+
+```bash
+# Run the migration test script
+pnpm run test:migration
+```
+
+## Troubleshooting
+
+### Migration Issues
+
+1. **Backup your code** before running migrations (or ensure you have git)
+2. **Review changes** with `git diff` after migration
+3. **Test your bot** after migration to ensure functionality
+4. **Check action logic** for any custom implementations that may need manual updates
+
+### Common Issues
+
+- **Custom action logic**: If your actions have complex business logic, you may need to manually adapt the async function pattern
+- **Custom messages**: The migration creates an empty custom messages structure - add your existing custom components
+- **Environment variables**: Ensure `VITE_HUBTYPE_APP_ID` is set for the modernized webchat
+- **Invalid projects**: If you specify invalid project names, the migration will list available bot projects
+
+### Project Selection
+
+- **Finding projects**: The migration will list all available bot projects if you specify an invalid one
+- **Mixed naming**: You can mix project names with and without `apps/` prefix in the same command
+- **Non-bot projects**: Projects without Botonic bot structure are automatically ignored
+
+### Safe Migration
+
+Migrations are designed to be safe:
+
+- **Idempotent**: Safe to run multiple times
+- **Conservative**: Only transforms known legacy patterns
+- **Preserves functionality**: Maintains the same bot behavior
+- **Project validation**: Validates project names before making changes
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch
+3. Add tests for new functionality
+4. Ensure all tests pass
+5. Submit a pull request
+
+## License
+
+MIT