@reechdesk/react 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Reechdesk
+
+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,71 @@
+# @reechdesk/react
+
+React SDK for Reechdesk — chat widget, ticket status checker, and knowledge base search.
+
+## Installation
+
+```bash
+npm install @reechdesk/react
+# or
+pnpm add @reechdesk/react
+```
+
+## Setup
+
+Wrap your app with `HelpdeskProvider`:
+
+```tsx
+import { HelpdeskProvider, ChatWidget } from '@reechdesk/react';
+
+function App() {
+  return (
+    <HelpdeskProvider entityId="your-entity-id">
+      <YourApp />
+      <ChatWidget />
+    </HelpdeskProvider>
+  );
+}
+```
+
+## Components
+
+### `<ChatWidget />`
+
+Floating chat bubble with a full chat window.
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `position` | `'bottom-right' \| 'bottom-left'` | `'bottom-right'` | Position of the chat bubble |
+| `primaryColor` | `string` | `'#f26522'` | Brand color |
+| `greeting` | `string` | `'Hi! How can we help?'` | Welcome message |
+| `poweredBy` | `boolean` | `true` | Show "Powered by Reechdesk" footer |
+| `soundEnabled` | `boolean` | `true` | Play sound on new messages |
+
+### `<TicketStatus />`
+
+Let customers check their ticket status.
+
+```tsx
+<TicketStatus ticketNumber="TKT-00123" />
+```
+
+| Prop | Type | Description |
+|------|------|-------------|
+| `ticketNumber` | `string` | Pre-fill ticket number |
+
+### `<KBSearch />`
+
+Embedded knowledge base search.
+
+```tsx
+<KBSearch placeholder="Search help articles..." maxResults={5} />
+```
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `placeholder` | `string` | `'Search help articles...'` | Input placeholder |
+| `maxResults` | `number` | `5` | Max results to show |
+
+## License
+
+MIT

package/dist/components/ChatWidget.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+interface ChatWidgetProps {
+    position?: 'bottom-right' | 'bottom-left';
+    primaryColor?: string;
+    greeting?: string;
+    entityName?: string;
+    logoUrl?: string | null;
+    borderRadius?: number;
+    inputBorderRadius?: number;
+    poweredBy?: boolean;
+    soundEnabled?: boolean;
+}
+export declare function ChatWidget({ position, primaryColor, greeting, entityName, logoUrl, borderRadius, inputBorderRadius, poweredBy, soundEnabled, }: ChatWidgetProps): React.JSX.Element;
+export {};

package/dist/components/HelpdeskProvider.d.ts

@@ -0,0 +1,36 @@
+import React from 'react';
+import PusherJS from 'pusher-js';
+export interface HelpdeskUser {
+    id: string;
+    name: string;
+    email: string;
+}
+export interface EntityBranding {
+    entityName: string;
+    logoUrl: string | null;
+    primaryColor: string;
+    greeting: string;
+    position: 'bottom-right' | 'bottom-left';
+    borderRadius: number;
+    poweredBy: boolean;
+    soundEnabled: boolean;
+}
+export interface HelpdeskContextValue {
+    entityId: string;
+    apiUrl: string;
+    user?: HelpdeskUser;
+    sessionId: string | null;
+    setSessionId: (id: string | null) => void;
+    pusher: PusherJS | null;
+    branding: EntityBranding;
+}
+export declare function useHelpdesk(): HelpdeskContextValue;
+interface HelpdeskProviderProps {
+    entityId: string;
+    apiUrl?: string;
+    user?: HelpdeskUser;
+    pusherKey?: string;
+    children: React.ReactNode;
+}
+export declare function HelpdeskProvider({ entityId, apiUrl, user, pusherKey, children, }: HelpdeskProviderProps): React.JSX.Element;
+export {};

package/dist/components/KBSearch.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+interface KBSearchProps {
+    placeholder?: string;
+    maxResults?: number;
+}
+export declare function KBSearch({ placeholder, maxResults, }: KBSearchProps): React.JSX.Element;
+export {};

package/dist/components/TicketStatus.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+interface TicketStatusProps {
+    ticketNumber?: string;
+}
+export declare function TicketStatus({ ticketNumber: initialTicket }: TicketStatusProps): React.JSX.Element;
+export {};

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { HelpdeskProvider, useHelpdesk } from './components/HelpdeskProvider';
+export type { HelpdeskUser, HelpdeskContextValue, EntityBranding } from './components/HelpdeskProvider';
+export { ChatWidget } from './components/ChatWidget';
+export { TicketStatus } from './components/TicketStatus';
+export { KBSearch } from './components/KBSearch';