react-jssip-kit 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,4 @@
+# Changelog
+
+## 0.1.0
+- Initial public release: React provider/hooks around bundled JsSIP client.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Victory Sip
+
+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,75 @@
+# react-jssip-kit
+
+React provider and hooks that wrap [JsSIP](https://jssip.net/) so you can manage SIP/WebRTC calls with idiomatic React state.
+
+## Installation
+
+```bash
+npm install react-jssip-kit jssip
+```
+
+Peer deps: `react@^18` and `react-dom@^18`.
+
+## Quick start
+
+```tsx
+import React from "react";
+import {
+  SipProvider,
+  useSipState,
+  useSipActions,
+  createSipClientInstance,
+  WebSocketInterface,
+} from "react-jssip-kit";
+
+const client = createSipClientInstance();
+
+client.connect("sip:alice@example.com", "supersecret", {
+  sockets: [new WebSocketInterface("wss://example.com/ws")],
+  uri: "sip:example.com",
+  display_name: "Alice",
+});
+
+function CallControls() {
+  const { sessions, sipStatus } = useSipState();
+  const { call, hangup, mute, unmute } = useSipActions();
+  const active = sessions[0];
+
+  return (
+    <div>
+      <div>Status: {sipStatus}</div>
+      <button onClick={() => call("sip:bob@example.com")}>Call Bob</button>
+      <button onClick={() => hangup(active?.id)}>Hang up</button>
+      <button onClick={() => mute(active?.id)}>Mute</button>
+      <button onClick={() => unmute(active?.id)}>Unmute</button>
+    </div>
+  );
+}
+
+export function App() {
+  return (
+    <SipProvider client={client}>
+      <CallControls />
+    </SipProvider>
+  );
+}
+```
+
+## API surface
+
+- `SipProvider` — supplies `SipClient` and `SipEventManager` to children.
+- Hooks: `useSip`, `useSipState`, `useSipActions`, `useSipEvent`, `useSipSessions`.
+- Components: `CallPlayer` (basic audio/video elements).
+- Utilities re-exported from bundled `jssip-lib`: `createSipClientInstance`, `createSipEventManager`, `WebSocketInterface`, status enums and types.
+
+## Build
+
+```bash
+npm run build
+```
+
+Outputs ESM + CJS + typings to `dist/`.
+
+## License
+
+MIT