@snipet/react-widget 0.0.0-stage → 0.2.1

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import type { Snipet, WidgetEvent, WidgetEvents, WidgetInit } from "@snipet/widget";
+export type * from "@snipet/widget";
+/** Event to the prop that handles it. */
+declare const EVENT_PROPS: {
+    readonly open: "onOpen";
+    readonly close: "onClose";
+    readonly message: "onMessage";
+    readonly error: "onError";
+};
+type EventProps = {
+    [E in WidgetEvent as (typeof EVENT_PROPS)[E]]?: (payload: WidgetEvents[E]) => void;
+};
+export type SnipetWidgetProps = WidgetInit & EventProps & {
+    /** Where to load the widget script from; defaults to the CDN build of the installed version. */
+    src?: string;
+};
+/**
+ * Mounts the chat widget while rendered; prop changes reach it like configure().
+ * Render it once, anywhere: the widget draws itself in the page corner, so this renders nothing.
+ */
+export declare function SnipetWidget({ src, onOpen, onClose, onMessage, onError, ...config }: SnipetWidgetProps): null;
+/** The widget's API: open, close, setToken, on... Safe to call before the widget loads. */
+export declare const useSnipet: () => Snipet;

package/dist/index.js

@@ -0,0 +1,27 @@
+"use client";
+import { snipet } from "@snipet/widget";
+import { useEffect, useRef } from "react";
+/** Event to the prop that handles it. */
+const EVENT_PROPS = { open: "onOpen", close: "onClose", message: "onMessage", error: "onError" };
+/**
+ * Mounts the chat widget while rendered; prop changes reach it like configure().
+ * Render it once, anywhere: the widget draws itself in the page corner, so this renders nothing.
+ */
+export function SnipetWidget({ src, onOpen, onClose, onMessage, onError, ...config }) {
+    const handlers = useRef({});
+    useEffect(() => {
+        handlers.current = { onOpen, onClose, onMessage, onError };
+    });
+    // The first run mounts; later ones (after any render) re-apply the config.
+    useEffect(() => snipet.init(config, src));
+    useEffect(() => {
+        const offs = Object.keys(EVENT_PROPS).map((event) => snipet.on(event, (payload) => handlers.current[EVENT_PROPS[event]]?.(payload)));
+        return () => {
+            offs.forEach((off) => off());
+            snipet.destroy();
+        };
+    }, []);
+    return null;
+}
+/** The widget's API: open, close, setToken, on... Safe to call before the widget loads. */
+export const useSnipet = () => snipet;

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@snipet/react-widget",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.1",
+  "description": "React bindings for the Snipet chat widget.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/usesnipet/snipet.git",
+    "directory": "packages/react-widget"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@snipet/widget": "0.2.1"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@types/react": "^19.3.0",
+    "react": "^19.3.0",
+    "typescript": "~6.0.3"
+  },
+  "scripts": {
+    "build": "tsc"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.