@bitux/review-layer-react 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @bitux/review-layer-react
2
2
 
3
- SDK de React para dejar comentarios de revisión (QA, UX, PM) directamente sobre la UI en entornos de staging. Se conecta a la API [review-layer-api](https://github.com/bitux/review-layer-api).
3
+ SDK de React para dejar comentarios de revisión (QA, UX, PM) directamente sobre la UI en entornos de staging. Se conecta a un backend de API (review-layer-api).
4
4
 
5
5
  ## Instalación
6
6
 
@@ -27,7 +27,7 @@ import { ReviewProvider } from "@bitux/review-layer-react";
27
27
  ```
28
28
 
29
29
  - **enabled**: activa o desactiva el SDK (p. ej. `import.meta.env.DEV` o `import.meta.env.VITE_REVIEW_ENABLED`).
30
- - **apiUrl**: base URL de la API (sin barra final), p. ej. `https://review-api.example.com/api`.
30
+ - **apiUrl**: base URL de la API (opcional). Si no la pasas, en producción se usa la API en Render (`https://review-layer-api.onrender.com/api`). En desarrollo local puedes pasar `http://localhost:8000/api`.
31
31
  - **apiKey**: API key del proyecto (generado en el backend por equipo/proyecto).
32
32
 
33
33
  ## Atajos
@@ -43,7 +43,7 @@ En modo revisión:
43
43
 
44
44
  ## Variables de entorno (ejemplo)
45
45
 
46
- En tu app de staging (Vite):
46
+ En desarrollo local puedes apuntar a tu API:
47
47
 
48
48
  ```env
49
49
  VITE_REVIEW_API_URL=http://localhost:8000/api
@@ -52,14 +52,16 @@ VITE_REVIEW_API_KEY=rl_xxx
52
52
 
53
53
  ```tsx
54
54
  <ReviewProvider
55
- enabled={import.meta.env.DEV}
56
- apiUrl={import.meta.env.VITE_REVIEW_API_URL ?? ""}
55
+ enabled={true}
56
+ apiUrl={import.meta.env.VITE_REVIEW_API_URL}
57
57
  apiKey={import.meta.env.VITE_REVIEW_API_KEY ?? ""}
58
58
  >
59
59
  <App />
60
60
  </ReviewProvider>
61
61
  ```
62
62
 
63
+ Si no pasas `apiUrl` (o la dejas `undefined`), el SDK usa por defecto la API en Render (`https://review-layer-api.onrender.com/api`), así que en producción no hace falta configurar nada más.
64
+
63
65
  ## Navegación SPA (React Router, etc.)
64
66
 
65
67
  Si usas rutas del lado cliente, al cambiar de ruta conviene volver a cargar los comentarios de la página actual. Usa el hook `useReview` y llama a `loadComments()` cuando cambie la ruta:
@@ -112,19 +114,3 @@ Se ejecutan pruebas de `selector` y de la capa `api` (con `fetch` mockeado).
112
114
  ```
113
115
 
114
116
  3. En la demo: **Shift + R** para activar modo revisión, haz clic en un elemento y envía un comentario. Comprueba que los pins aparecen y que en la API se crean los comentarios.
115
-
116
- ## Publicar en npm
117
-
118
- 1. **Cuenta npm**: crea una en [npmjs.com](https://www.npmjs.com/) si no tienes. Para un paquete con scope (`@bitux/review-layer-react`) la primera vez debes publicar como público (en `package.json` ya está `"publishConfig": { "access": "public" }`).
119
-
120
- 2. **Repository**: la URL del repo en `package.json` apunta a `github.com/bitux/review-layer-react`. Ajusta si el nombre del repo es otro.
121
-
122
- 3. **Build y publicar**:
123
-
124
- ```bash
125
- npm run build
126
- npm login
127
- npm publish
128
- ```
129
-
130
- Las versiones siguientes: cambia `version` en `package.json` (o usa `npm version patch`) y vuelve a `npm run build` y `npm publish`.
@@ -1,5 +1,7 @@
1
1
  import { Reviewer, Comment } from './utils/api';
2
2
 
3
+ /** URL por defecto de la API en producción (Render). Si no pasas apiUrl, se usa esta. */
4
+ export declare const DEFAULT_API_URL = "https://review-layer-api.onrender.com/api";
3
5
  interface ReviewContextValue {
4
6
  apiUrl: string;
5
7
  apiKey: string;
@@ -15,8 +17,9 @@ export declare function useReview(): ReviewContextValue;
15
17
  export interface ReviewProviderProps {
16
18
  children: React.ReactNode;
17
19
  enabled?: boolean;
18
- apiUrl: string;
20
+ /** URL base de la API. Si no se pasa, se usa la de producción (Render). */
21
+ apiUrl?: string;
19
22
  apiKey: string;
20
23
  }
21
- export declare function ReviewProvider({ children, enabled, apiUrl, apiKey, }: ReviewProviderProps): import("react/jsx-runtime").JSX.Element;
24
+ export declare function ReviewProvider({ children, enabled, apiUrl: apiUrlProp, apiKey, }: ReviewProviderProps): import("react/jsx-runtime").JSX.Element;
22
25
  export {};
package/dist/index.d.ts CHANGED
@@ -1,3 +1,3 @@
1
- export { ReviewProvider, useReview } from './ReviewProvider';
1
+ export { ReviewProvider, useReview, DEFAULT_API_URL } from './ReviewProvider';
2
2
  export type { ReviewProviderProps } from './ReviewProvider';
3
3
  export type { Reviewer, Comment } from './utils/api';