PR #4: Split JS Pro Code to Separate Package (#1841)

- Refactored code to move JS Pro-related logic into its own package for better modularity and maintainability.
- Updated dependencies and documentation to reflect the new package structure.
- Ensured backward compatibility and provided migration instructions where necessary.

Author: AbanoubGhadban

.github/workflows/lint-js-and-ruby.yml

@@ -84,7 +84,8 @@ jobs:
         run: cd packages/react-on-rails && yarn pack -f react-on-rails.tgz
       - name: Lint package types
         # our package is ESM-only
-        run: yarn run attw packages/react-on-rails/react-on-rails.tgz --profile esm-only
+        # Exclude internal exports used for react-on-rails-pro communication
+        run: yarn run attw packages/react-on-rails/react-on-rails.tgz --profile esm-only --exclude-entrypoints reactApis ReactDOMServer
       - name: Lint package publishing
         run: yarn run publint --strict packages/react-on-rails/react-on-rails.tgz
       # We only download and run Actionlint if there is any difference in GitHub Action workflows

.github/workflows/package-js-tests.yml

@@ -36,5 +36,7 @@ jobs:
         run: |
           yarn install --no-progress --no-emoji ${{ matrix.node-version == '22' && '--frozen-lockfile' || '' }}
           sudo yarn global add yalc
+      - name: Build Renderer package
+        run: yarn build
       - name: Run JS unit tests for Renderer package
         run: yarn test

.gitignore

@@ -22,6 +22,15 @@ node_modules
 
 /packages/*/lib
 
+# TypeScript build artifacts in src (shouldn't be there, but just in case)
+/packages/*/src/**/*.js
+/packages/*/src/**/*.d.ts
+/packages/*/src/**/*.d.cts
+/packages/*/src/**/*.cjs
+/packages/*/src/**/*.map
+!/packages/*/src/**/*.test.js
+!/packages/*/src/**/*.spec.js
+
 yarn-debug.*
 yarn-error.*
 npm-debug.*

CHANGELOG.md

@@ -23,6 +23,52 @@ After a release, please make sure to run `bundle exec rake update_changelog`. Th
 
 Changes since the last non-beta release.
 
+#### Breaking Changes
+
+- **React on Rails Core Package**: Several Pro-only methods have been removed from the core package and are now exclusively available in the `react-on-rails-pro` package. If you're using any of the following methods, you'll need to migrate to React on Rails Pro:
+  - `getOrWaitForComponent()`
+  - `getOrWaitForStore()`
+  - `getOrWaitForStoreGenerator()`
+  - `reactOnRailsStoreLoaded()`
+  - `streamServerRenderedReactComponent()`
+  - `serverRenderRSCReactComponent()`
+
+**Migration Guide:**
+
+To migrate to React on Rails Pro:
+
+1. Install the Pro package:
+
+   ```bash
+   yarn add react-on-rails-pro
+   # or
+   npm install react-on-rails-pro
+   ```
+
+2. Update your imports from `react-on-rails` to `react-on-rails-pro`:
+
+   ```javascript
+   // Before
+   import ReactOnRails from 'react-on-rails';
+
+   // After
+   import ReactOnRails from 'react-on-rails-pro';
+   ```
+
+3. For server-side rendering, update your import paths:
+
+   ```javascript
+   // Before
+   import ReactOnRails from 'react-on-rails';
+
+   // After
+   import ReactOnRails from 'react-on-rails-pro';
+   ```
+
+4. If you're using a free license for personal (non-production) use, you can obtain one at [React on Rails Pro License](https://www.shakacode.com/react-on-rails-pro). The Pro package is free for personal, educational, and non-production usage.
+
+**Note:** If you're not using any of the Pro-only methods listed above, no changes are required.
+
 ### [16.1.1] - 2025-09-24
 
 #### Bug Fixes
@@ -71,7 +117,7 @@ Changes since the last non-beta release.
 
 #### Pro License Features
 
-- **Core/Pro separation**: Moved Pro features into dedicated `lib/react_on_rails/pro/` and `node_package/src/pro/` directories with clear licensing boundaries (now located at `packages/react-on-rails/src/pro/`) [PR 1791](https://github.com/shakacode/react_on_rails/pull/1791) by [AbanoubGhadban](https://github.com/AbanoubGhadban)
+- **Core/Pro separation**: Moved Pro features into dedicated `lib/react_on_rails/pro/` and `node_package/src/pro/` directories with clear licensing boundaries (now separated into `packages/react-on-rails-pro/` package) [PR 1791](https://github.com/shakacode/react_on_rails/pull/1791) by [AbanoubGhadban](https://github.com/AbanoubGhadban)
 - **Runtime license validation**: Implemented Pro license gating with graceful fallback to core functionality when Pro license unavailable [PR 1791](https://github.com/shakacode/react_on_rails/pull/1791) by [AbanoubGhadban](https://github.com/AbanoubGhadban)
 - **Enhanced immediate hydration**: Improved immediate hydration functionality with Pro license validation and warning badges [PR 1791](https://github.com/shakacode/react_on_rails/pull/1791) by [AbanoubGhadban](https://github.com/AbanoubGhadban)
 - **License documentation**: Added NOTICE files in Pro directories referencing canonical `REACT-ON-RAILS-PRO-LICENSE.md` [PR 1791](https://github.com/shakacode/react_on_rails/pull/1791) by [AbanoubGhadban](https://github.com/AbanoubGhadban)

LICENSE.md

@@ -12,17 +12,15 @@ This repository contains code under two different licenses:
 The following directories and all their contents are licensed under the **MIT License** (see full text below):
 
 - `lib/react_on_rails/` (excluding `lib/react_on_rails/pro/`)
-- `packages/react-on-rails/` (excluding `packages/react-on-rails/src/pro/`)
-- `packages/react-on-rails/lib/` (excluding `packages/react-on-rails/lib/pro/`)
+- `packages/react-on-rails/` (entire package)
 - All other directories in this repository not explicitly listed as Pro-licensed
 
 ### Pro Licensed Code
 
 The following directories and all their contents are licensed under the **React on Rails Pro License**:
 
 - `lib/react_on_rails/pro/`
-- `packages/react-on-rails/src/pro/`
-- `packages/react-on-rails/lib/pro/`
+- `packages/react-on-rails-pro/` (entire package)
 - `react_on_rails_pro/` (entire directory)
 
 See [REACT-ON-RAILS-PRO-LICENSE.md](./REACT-ON-RAILS-PRO-LICENSE.md) for complete Pro license terms.