@emplorium/sdk 0.1.0

package/dist/react/index.mjs

@@ -0,0 +1,85 @@
+import {
+  EmploriumClient
+} from "../chunk-DYG422DG.mjs";
+
+// src/react/EmploriumProvider.tsx
+import { useEffect, useMemo, useRef } from "react";
+
+// src/react/context.ts
+import React from "react";
+var EmploriumContext = React.createContext(null);
+
+// src/react/EmploriumProvider.tsx
+import { jsx } from "react/jsx-runtime";
+var EmploriumProvider = ({ config, children, autoOpen }) => {
+  var _a;
+  const clientRef = useRef(null);
+  const accountIdRef = useRef(null);
+  const mergedConfig = useMemo(
+    () => {
+      var _a2;
+      return {
+        ...config,
+        autoOpen: (_a2 = config.autoOpen) != null ? _a2 : autoOpen
+      };
+    },
+    [config, autoOpen]
+  );
+  if (!clientRef.current || accountIdRef.current !== mergedConfig.accountId) {
+    (_a = clientRef.current) == null ? void 0 : _a.destroy();
+    clientRef.current = new EmploriumClient(mergedConfig);
+    accountIdRef.current = mergedConfig.accountId;
+  }
+  useEffect(() => {
+    const client = clientRef.current;
+    if (!client)
+      return;
+    client.init().then(() => {
+      if (mergedConfig.autoOpen) {
+        client.open();
+      }
+    });
+    return () => client.destroy();
+  }, [mergedConfig]);
+  return /* @__PURE__ */ jsx(EmploriumContext.Provider, { value: clientRef.current, children });
+};
+
+// src/react/EmploriumWidget.tsx
+import { useEffect as useEffect2 } from "react";
+
+// src/react/useEmplorium.ts
+import { useContext } from "react";
+var useEmplorium = () => {
+  const client = useContext(EmploriumContext);
+  if (!client) {
+    throw new Error("useEmplorium must be used within an EmploriumProvider");
+  }
+  return client;
+};
+
+// src/react/EmploriumWidget.tsx
+var EmploriumWidget = ({ autoOpen, onReady }) => {
+  const client = useEmplorium();
+  useEffect2(() => {
+    let active = true;
+    client.ready().then(() => {
+      if (!active)
+        return;
+      if (autoOpen) {
+        client.open();
+      }
+      onReady == null ? void 0 : onReady();
+    }).catch(() => {
+    });
+    return () => {
+      active = false;
+    };
+  }, [autoOpen, client, onReady]);
+  return null;
+};
+export {
+  EmploriumProvider,
+  EmploriumWidget,
+  useEmplorium
+};
+//# sourceMappingURL=index.mjs.map

package/dist/react/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/EmploriumProvider.tsx","../../src/react/context.ts","../../src/react/EmploriumWidget.tsx","../../src/react/useEmplorium.ts"],"sourcesContent":["import React, { ReactNode, useEffect, useMemo, useRef } from \"react\";\n\nimport { EmploriumClient } from \"../client\";\nimport { EmploriumConfig } from \"../types\";\nimport { EmploriumContext } from \"./context\";\n\ntype ProviderProps = {\n  config: EmploriumConfig;\n  children?: ReactNode;\n  /**\n   * If true, the widget will open once ready.\n   */\n  autoOpen?: boolean;\n};\n\nexport const EmploriumProvider: React.FC<ProviderProps> = ({ config, children, autoOpen }) => {\n  const clientRef = useRef<EmploriumClient | null>(null);\n  const accountIdRef = useRef<string | null>(null);\n\n  const mergedConfig = useMemo(\n    () => ({\n      ...config,\n      autoOpen: config.autoOpen ?? autoOpen,\n    }),\n    [config, autoOpen]\n  );\n\n  if (!clientRef.current || accountIdRef.current !== mergedConfig.accountId) {\n    clientRef.current?.destroy();\n    clientRef.current = new EmploriumClient(mergedConfig);\n    accountIdRef.current = mergedConfig.accountId;\n  }\n\n  useEffect(() => {\n    const client = clientRef.current;\n    if (!client) return;\n    client.init().then(() => {\n      if (mergedConfig.autoOpen) {\n        client.open();\n      }\n    });\n\n    return () => client.destroy();\n  }, [mergedConfig]);\n\n  return (\n    <EmploriumContext.Provider value={clientRef.current}>{children}</EmploriumContext.Provider>\n  );\n};\n","import React from \"react\";\nimport { EmploriumClient } from \"../client\";\n\nexport const EmploriumContext = React.createContext<EmploriumClient | null>(null);\n","import { useEffect } from \"react\";\n\nimport { useEmplorium } from \"./useEmplorium\";\n\ntype WidgetProps = {\n  /**\n   * Open the widget when ready.\n   */\n  autoOpen?: boolean;\n  /**\n   * Callback when the widget signals readiness.\n   */\n  onReady?: () => void;\n};\n\nexport const EmploriumWidget: React.FC<WidgetProps> = ({ autoOpen, onReady }) => {\n  const client = useEmplorium();\n\n  useEffect(() => {\n    let active = true;\n    client\n      .ready()\n      .then(() => {\n        if (!active) return;\n        if (autoOpen) {\n          client.open();\n        }\n        onReady?.();\n      })\n      .catch(() => {\n        /* errors are surfaced through the client's event bus */\n      });\n\n    return () => {\n      active = false;\n    };\n  }, [autoOpen, client, onReady]);\n\n  return null;\n};\n","import { useContext } from \"react\";\n\nimport { EmploriumContext } from \"./context\";\n\nexport const useEmplorium = () => {\n  const client = useContext(EmploriumContext);\n  if (!client) {\n    throw new Error(\"useEmplorium must be used within an EmploriumProvider\");\n  }\n  return client;\n};\n"],"mappings":";;;;;AAAA,SAA2B,WAAW,SAAS,cAAc;;;ACA7D,OAAO,WAAW;AAGX,IAAM,mBAAmB,MAAM,cAAsC,IAAI;;;AD2C5E;AA/BG,IAAM,oBAA6C,CAAC,EAAE,QAAQ,UAAU,SAAS,MAAM;AAf9F;AAgBE,QAAM,YAAY,OAA+B,IAAI;AACrD,QAAM,eAAe,OAAsB,IAAI;AAE/C,QAAM,eAAe;AAAA,IACnB,MAAG;AApBP,UAAAA;AAoBW;AAAA,QACL,GAAG;AAAA,QACH,WAAUA,MAAA,OAAO,aAAP,OAAAA,MAAmB;AAAA,MAC/B;AAAA;AAAA,IACA,CAAC,QAAQ,QAAQ;AAAA,EACnB;AAEA,MAAI,CAAC,UAAU,WAAW,aAAa,YAAY,aAAa,WAAW;AACzE,oBAAU,YAAV,mBAAmB;AACnB,cAAU,UAAU,IAAI,gBAAgB,YAAY;AACpD,iBAAa,UAAU,aAAa;AAAA,EACtC;AAEA,YAAU,MAAM;AACd,UAAM,SAAS,UAAU;AACzB,QAAI,CAAC;AAAQ;AACb,WAAO,KAAK,EAAE,KAAK,MAAM;AACvB,UAAI,aAAa,UAAU;AACzB,eAAO,KAAK;AAAA,MACd;AAAA,IACF,CAAC;AAED,WAAO,MAAM,OAAO,QAAQ;AAAA,EAC9B,GAAG,CAAC,YAAY,CAAC;AAEjB,SACE,oBAAC,iBAAiB,UAAjB,EAA0B,OAAO,UAAU,SAAU,UAAS;AAEnE;;;AEhDA,SAAS,aAAAC,kBAAiB;;;ACA1B,SAAS,kBAAkB;AAIpB,IAAM,eAAe,MAAM;AAChC,QAAM,SAAS,WAAW,gBAAgB;AAC1C,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,uDAAuD;AAAA,EACzE;AACA,SAAO;AACT;;;ADKO,IAAM,kBAAyC,CAAC,EAAE,UAAU,QAAQ,MAAM;AAC/E,QAAM,SAAS,aAAa;AAE5B,EAAAC,WAAU,MAAM;AACd,QAAI,SAAS;AACb,WACG,MAAM,EACN,KAAK,MAAM;AACV,UAAI,CAAC;AAAQ;AACb,UAAI,UAAU;AACZ,eAAO,KAAK;AAAA,MACd;AACA;AAAA,IACF,CAAC,EACA,MAAM,MAAM;AAAA,IAEb,CAAC;AAEH,WAAO,MAAM;AACX,eAAS;AAAA,IACX;AAAA,EACF,GAAG,CAAC,UAAU,QAAQ,OAAO,CAAC;AAE9B,SAAO;AACT;","names":["_a","useEffect","useEffect"]}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@emplorium/sdk",
+  "version": "0.1.0",
+  "description": "Official browser SDK for embedding the Emplorium chat widget with programmatic control.",
+  "license": "SEE LICENSE IN LICENSE",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup src/index.ts src/react/index.ts --dts --format esm,cjs --sourcemap --clean --external react,react-dom",
+    "dev": "tsup src/index.ts src/react/index.ts --watch --external react,react-dom"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/react/index.mjs",
+      "require": "./dist/react/index.js",
+      "types": "./dist/react/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": ">=18 <20",
+    "react-dom": ">=18 <20"
+  },
+  "devDependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsup": "^7.3.0",
+    "typescript": "^5.4.0"
+  },
+  "dependencies": {
+    "tslib": "^2.6.2"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}