@ops-ai/react-router-toggly 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 1.0.0
+
+### Added
+
+- Initial `@ops-ai/react-router-toggly` release for React Router 7/8 framework mode
+- Folded Remix core/client/server into one package with `./client` and `./server` exports
+- In-source core (eval, telemetry, types) — no dependency on `@ops-ai/remix-toggly-core`
+- Peers: `react-router ^7 || ^8`, `react` / `react-dom ^18 || ^19`, optional `@react-router/node`
+- Packed host coverage for RR7+React 18 and RR8+React 19.2.7+
+
+### Migration
+
+- `@ops-ai/remix-toggly-*` is deprecated. Use `@ops-ai/react-router-toggly` instead.
+- Rename `RemixTogglyProvider` → `RouterTogglyProvider`
+- Import from `@ops-ai/react-router-toggly/client` and `@ops-ai/react-router-toggly/server`

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-2026 opsAI LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,107 @@
+# @ops-ai/react-router-toggly
+
+Toggly feature flags for **React Router 7/8 framework mode**. One package with
+`./client` and `./server` entry points. Core evaluation and telemetry live
+in-source (not published as a separate package).
+
+> Migrating from `@ops-ai/remix-toggly-*`? Those packages are deprecated. Install
+> `@ops-ai/react-router-toggly` and import from `/client` and `/server`.
+
+## Install
+
+```bash
+npm install @ops-ai/react-router-toggly react-router react react-dom
+```
+
+Peers: `react-router ^7 || ^8`, `react` / `react-dom ^18 || ^19`. Optional:
+`@react-router/node`. Requires Node `>=18`.
+
+## Quick start
+
+### Server loader
+
+```ts
+// app/toggly.server.ts
+import { createTogglyLoader } from '@ops-ai/react-router-toggly/server';
+
+export const toggly = createTogglyLoader({
+  appKey: process.env.TOGGLY_APP_KEY!,
+  environment: process.env.TOGGLY_ENVIRONMENT ?? 'Production',
+  getIdentity: async (request) => {
+    // Resolve session identity for this request
+    return null;
+  },
+});
+```
+
+```tsx
+// app/root.tsx
+import { Outlet } from 'react-router';
+import { RouterTogglyProvider } from '@ops-ai/react-router-toggly/client';
+import { toggly } from './toggly.server';
+
+export async function loader(args: { request: Request }) {
+  return toggly.getLoaderData(args);
+}
+
+export default function App() {
+  return (
+    <RouterTogglyProvider routeId="root">
+      <Outlet />
+    </RouterTogglyProvider>
+  );
+}
+```
+
+### Client gates
+
+```tsx
+import { Feature, useFeature } from '@ops-ai/react-router-toggly/client';
+
+export default function Home() {
+  const beta = useFeature('Beta');
+  return (
+    <Feature feature="Checkout">
+      <Checkout />
+      {beta ? <BetaBanner /> : null}
+    </Feature>
+  );
+}
+```
+
+### Feature-gated actions
+
+```ts
+import { createFeatureGatedAction } from '@ops-ai/react-router-toggly/server';
+
+export const action = createFeatureGatedAction(
+  {
+    appKey: process.env.TOGGLY_APP_KEY!,
+    requiredFeatures: 'AdminTools',
+  },
+  async () => ({ ok: true }),
+);
+```
+
+## Exports
+
+| Subpath | Purpose |
+|---------|---------|
+| `@ops-ai/react-router-toggly/client` | `RouterTogglyProvider`, hooks, `Feature` components |
+| `@ops-ai/react-router-toggly/server` | Loaders, actions, `TogglyServerClient` |
+
+Server-only modules (`ws`, gRPC telemetry) must not be imported from client code.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+npm run test:coverage
+npm run test:hosts   # packed RR7/RR8 hosts (needs matching Node majors)
+```
+
+## License
+
+MIT