@guidelytech/react 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# @guidelytech/react
 
-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.
+React provider and hooks for Guidely. Wraps `@guidelytech/sdk-core`; works with React 18/19, SSR and
+Strict Mode.
+
+```bash
+pnpm add @guidelytech/react
+```
+
+```tsx
+import { GuidelyProvider, useGuidely } from "@guidelytech/react";
+
+export function App({ children }) {
+  return (
+    <GuidelyProvider projectId="pk_dev_…" apiUrl="http://localhost:3000" user={{ id: "u1", traits: { role: "admin" } }}>
+      {children}
+    </GuidelyProvider>
+  );
+}
+
+function HelpMenu() {
+  const guidely = useGuidely();
+  return <button onClick={() => guidely.startGuide("new-user-onboarding")}>Restart tour</button>;
+}
+```
+
+| Export | Description |
+|---|---|
+| `GuidelyProvider` | Accepts every `GuidelyOptions` field plus `user?: { id, traits?, account? }` and `children`. Creates the client inside an effect (never during SSR), destroys it on unmount; Strict Mode's double invoke yields exactly one live client. Changing `projectId`/`environment`/`apiUrl` recreates the client; changing `user` re-identifies (`undefined` resets). |
+| `useGuidely()` | The client, or a no-op proxy on the server / before mount (methods return `false`, `[]`, `null` or resolved promises). |
+| `useGuidelyReady()` | `true` once config is loaded. |
+| `useGuidelyIdentify(userId, traits?, account?)` | Effect helper that identifies when the arguments change. |
+| `useGuidelyEvent(event, handler)` | Subscribes for the component lifetime (latest handler is used). |
+| `useChecklistProgress(idOrKey)` | Live `{ completedTaskIds, completedAt, dismissedAt }`. |
+| `useGuideState(idOrKey)` | Live `{ active, completed, stepId, stepIndex, guide }`. |
+| `noopClient` | The no-op client instance. |
+
+Types re-exported: `GuidelyClient`, `GuidelyOptions`, `GuidelyEvents`, `GuidelyUser`,
+`ChecklistProgressState`, `PublishedGuide`, `GuideState`, `GuidelyProviderProps`.

package/dist/index.cjs

@@ -0,0 +1,165 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.tsx
+var index_exports = {};
+__export(index_exports, {
+  GuidelyProvider: () => GuidelyProvider,
+  noopClient: () => noopClient,
+  useChecklistProgress: () => useChecklistProgress,
+  useGuideState: () => useGuideState,
+  useGuidely: () => useGuidely,
+  useGuidelyEvent: () => useGuidelyEvent,
+  useGuidelyIdentify: () => useGuidelyIdentify,
+  useGuidelyReady: () => useGuidelyReady
+});
+module.exports = __toCommonJS(index_exports);
+var import_sdk_core = require("@guidelytech/sdk-core");
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var GuidelyContext = (0, import_react.createContext)(null);
+function GuidelyProvider({ children, user, ...options }) {
+  const [client, setClient] = (0, import_react.useState)(null);
+  const optionsRef = (0, import_react.useRef)(options);
+  optionsRef.current = options;
+  const { projectId, environment, apiUrl } = options;
+  (0, import_react.useEffect)(() => {
+    if (typeof window === "undefined" || !projectId) return;
+    const c = (0, import_sdk_core.createGuidely)({ ...optionsRef.current, projectId, environment, apiUrl });
+    setClient(c);
+    return () => {
+      c.destroy();
+      setClient((cur) => cur === c ? null : cur);
+    };
+  }, [projectId, environment, apiUrl]);
+  const userKey = user ? JSON.stringify([user.id, user.traits ?? null, user.account ?? null]) : "";
+  const hadUser = (0, import_react.useRef)(false);
+  (0, import_react.useEffect)(() => {
+    if (!client) return;
+    if (user && user.id) {
+      hadUser.current = true;
+      void client.identify(user.id, user.traits, user.account);
+    } else if (hadUser.current) {
+      hadUser.current = false;
+      client.reset();
+    }
+  }, [client, userKey]);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(GuidelyContext.Provider, { value: client, children });
+}
+var NOOP_RESULTS = {
+  init: Promise.resolve(),
+  ready: Promise.resolve(),
+  identify: Promise.resolve(),
+  setAccount: Promise.resolve(),
+  updateTraits: Promise.resolve(),
+  refresh: Promise.resolve(),
+  startGuide: false,
+  getActiveGuide: null,
+  getGuides: [],
+  getChecklistProgress: { completedTaskIds: [], completedAt: null, dismissedAt: null },
+  isGuideCompleted: false,
+  on: () => {
+  },
+  getState: { ready: false, destroyed: false },
+  getContext: null
+};
+var noopClient = new Proxy({}, {
+  get(_target, prop) {
+    if (prop === "options") return { projectId: "" };
+    if (typeof prop !== "string") return void 0;
+    return () => NOOP_RESULTS[prop];
+  }
+});
+function useGuidely() {
+  return (0, import_react.useContext)(GuidelyContext) ?? noopClient;
+}
+function useGuidelyReady() {
+  const client = (0, import_react.useContext)(GuidelyContext);
+  const [ready, setReady] = (0, import_react.useState)(false);
+  (0, import_react.useEffect)(() => {
+    if (!client) {
+      setReady(false);
+      return;
+    }
+    if (client.getState().ready) setReady(true);
+    return client.on("ready", () => setReady(true));
+  }, [client]);
+  return ready;
+}
+function useGuidelyIdentify(userId, traits, account) {
+  const client = (0, import_react.useContext)(GuidelyContext);
+  const key = JSON.stringify([userId ?? null, traits ?? null, account ?? null]);
+  (0, import_react.useEffect)(() => {
+    if (!client || !userId) return;
+    void client.identify(userId, traits, account);
+  }, [client, key]);
+}
+function useGuidelyEvent(event, handler) {
+  const client = (0, import_react.useContext)(GuidelyContext);
+  const ref = (0, import_react.useRef)(handler);
+  ref.current = handler;
+  (0, import_react.useEffect)(() => {
+    if (!client) return;
+    const cb = ((...args) => ref.current(...args));
+    return client.on(event, cb);
+  }, [client, event]);
+}
+function useChecklistProgress(idOrKey) {
+  const client = (0, import_react.useContext)(GuidelyContext);
+  const [progress, setProgress] = (0, import_react.useState)({ completedTaskIds: [], completedAt: null, dismissedAt: null });
+  (0, import_react.useEffect)(() => {
+    if (!client) return;
+    const update = () => setProgress(client.getChecklistProgress(idOrKey));
+    update();
+    const offs = [client.on("ready", update), client.on("identify", update), client.on("checklist:task", update), client.on("checklist:complete", update)];
+    return () => offs.forEach((off) => off());
+  }, [client, idOrKey]);
+  return progress;
+}
+function useGuideState(idOrKey) {
+  const client = (0, import_react.useContext)(GuidelyContext);
+  const [state, setState] = (0, import_react.useState)({ active: false, completed: false, stepId: null, stepIndex: -1, guide: null });
+  (0, import_react.useEffect)(() => {
+    if (!client) return;
+    const matches = (g) => g.id === idOrKey || g.key === idOrKey;
+    const compute = () => {
+      const guide = client.getGuides().find(matches) ?? null;
+      const active = client.getActiveGuide();
+      const s = client.getState().activeGuide;
+      setState({ active: !!active && matches(active), completed: client.isGuideCompleted(idOrKey), stepId: active && matches(active) ? s?.stepId ?? null : null, stepIndex: active && matches(active) ? s?.stepIndex ?? -1 : -1, guide });
+    };
+    compute();
+    const offs = ["ready", "identify", "guide:start", "guide:step", "guide:complete", "guide:dismiss", "guide:skip"].map((e) => client.on(e, compute));
+    return () => offs.forEach((off) => off());
+  }, [client, idOrKey]);
+  return state;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GuidelyProvider,
+  noopClient,
+  useChecklistProgress,
+  useGuideState,
+  useGuidely,
+  useGuidelyEvent,
+  useGuidelyIdentify,
+  useGuidelyReady
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"sourcesContent":["import { createGuidely, type ChecklistProgressState, type GuidelyClient, type GuidelyEvents, type GuidelyOptions, type GuidelyUser, type PublishedGuide } from \"@guidelytech/sdk-core\";\nimport { createContext, useContext, useEffect, useRef, useState, type ReactNode } from \"react\";\n\nexport type { GuidelyClient, GuidelyOptions, GuidelyEvents, GuidelyUser, ChecklistProgressState, PublishedGuide } from \"@guidelytech/sdk-core\";\n\nconst GuidelyContext = createContext<GuidelyClient | null>(null);\n\nexport interface GuidelyProviderProps extends Omit<GuidelyOptions, \"user\"> {\n  /** Identify this user as soon as the client is ready; `undefined` resets the identity. */\n  user?: GuidelyUser | null;\n  children?: ReactNode;\n}\n\n/**\n * Creates one Guidely client for the subtree. The client is created inside an effect (never\n * during SSR) and destroyed on unmount, so React Strict Mode's double-invoke is harmless.\n */\nexport function GuidelyProvider({ children, user, ...options }: GuidelyProviderProps) {\n  const [client, setClient] = useState<GuidelyClient | null>(null);\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  const { projectId, environment, apiUrl } = options;\n\n  useEffect(() => {\n    if (typeof window === \"undefined\" || !projectId) return;\n    const c = createGuidely({ ...optionsRef.current, projectId, environment, apiUrl });\n    setClient(c);\n    return () => {\n      c.destroy();\n      setClient((cur) => (cur === c ? null : cur));\n    };\n  }, [projectId, environment, apiUrl]);\n\n  const userKey = user ? JSON.stringify([user.id, user.traits ?? null, user.account ?? null]) : \"\";\n  const hadUser = useRef(false);\n  useEffect(() => {\n    if (!client) return;\n    if (user && user.id) {\n      hadUser.current = true;\n      void client.identify(user.id, user.traits, user.account);\n    } else if (hadUser.current) {\n      hadUser.current = false;\n      client.reset();\n    }\n  }, [client, userKey]);\n\n  return <GuidelyContext.Provider value={client}>{children}</GuidelyContext.Provider>;\n}\n\nconst NOOP_RESULTS: Record<string, unknown> = {\n  init: Promise.resolve(),\n  ready: Promise.resolve(),\n  identify: Promise.resolve(),\n  setAccount: Promise.resolve(),\n  updateTraits: Promise.resolve(),\n  refresh: Promise.resolve(),\n  startGuide: false,\n  getActiveGuide: null,\n  getGuides: [],\n  getChecklistProgress: { completedTaskIds: [], completedAt: null, dismissedAt: null },\n  isGuideCompleted: false,\n  on: () => {},\n  getState: { ready: false, destroyed: false },\n  getContext: null,\n};\n\n/** A client that ignores every call; returned by `useGuidely()` on the server and before the provider mounts. */\nexport const noopClient: GuidelyClient = new Proxy({} as GuidelyClient, {\n  get(_target, prop) {\n    if (prop === \"options\") return { projectId: \"\" };\n    if (typeof prop !== \"string\") return undefined;\n    return () => NOOP_RESULTS[prop];\n  },\n});\n\n/** The Guidely client, or a no-op client during SSR / before the provider has mounted. */\nexport function useGuidely(): GuidelyClient {\n  return useContext(GuidelyContext) ?? noopClient;\n}\n\n/** True once the client has loaded its configuration. */\nexport function useGuidelyReady(): boolean {\n  const client = useContext(GuidelyContext);\n  const [ready, setReady] = useState(false);\n  useEffect(() => {\n    if (!client) {\n      setReady(false);\n      return;\n    }\n    if (client.getState().ready) setReady(true);\n    return client.on(\"ready\", () => setReady(true));\n  }, [client]);\n  return ready;\n}\n\n/** Identifies the user whenever the arguments change. */\nexport function useGuidelyIdentify(userId: string | null | undefined, traits?: Record<string, unknown>, account?: GuidelyUser[\"account\"]): void {\n  const client = useContext(GuidelyContext);\n  const key = JSON.stringify([userId ?? null, traits ?? null, account ?? null]);\n  useEffect(() => {\n    if (!client || !userId) return;\n    void client.identify(userId, traits, account);\n  }, [client, key]);\n}\n\n/** Subscribes to a client event for the lifetime of the component. */\nexport function useGuidelyEvent<K extends keyof GuidelyEvents>(event: K, handler: GuidelyEvents[K]): void {\n  const client = useContext(GuidelyContext);\n  const ref = useRef(handler);\n  ref.current = handler;\n  useEffect(() => {\n    if (!client) return;\n    const cb = ((...args: unknown[]) => (ref.current as (...a: unknown[]) => void)(...args)) as GuidelyEvents[K];\n    return client.on(event, cb);\n  }, [client, event]);\n}\n\n/** Live checklist progress for a checklist guide (by id or key). */\nexport function useChecklistProgress(idOrKey: string): ChecklistProgressState {\n  const client = useContext(GuidelyContext);\n  const [progress, setProgress] = useState<ChecklistProgressState>({ completedTaskIds: [], completedAt: null, dismissedAt: null });\n  useEffect(() => {\n    if (!client) return;\n    const update = () => setProgress(client.getChecklistProgress(idOrKey));\n    update();\n    const offs = [client.on(\"ready\", update), client.on(\"identify\", update), client.on(\"checklist:task\", update), client.on(\"checklist:complete\", update)];\n    return () => offs.forEach((off) => off());\n  }, [client, idOrKey]);\n  return progress;\n}\n\nexport interface GuideState {\n  /** The guide is currently showing. */\n  active: boolean;\n  completed: boolean;\n  stepId: string | null;\n  stepIndex: number;\n  guide: PublishedGuide | null;\n}\n\n/** Live state of a guide (by id or key): active, completed, current step. */\nexport function useGuideState(idOrKey: string): GuideState {\n  const client = useContext(GuidelyContext);\n  const [state, setState] = useState<GuideState>({ active: false, completed: false, stepId: null, stepIndex: -1, guide: null });\n  useEffect(() => {\n    if (!client) return;\n    const matches = (g: PublishedGuide) => g.id === idOrKey || g.key === idOrKey;\n    const compute = () => {\n      const guide = client.getGuides().find(matches) ?? null;\n      const active = client.getActiveGuide();\n      const s = client.getState().activeGuide;\n      setState({ active: !!active && matches(active), completed: client.isGuideCompleted(idOrKey), stepId: active && matches(active) ? ((s as { stepId?: string | null } | null)?.stepId ?? null) : null, stepIndex: active && matches(active) ? ((s as { stepIndex?: number } | null)?.stepIndex ?? -1) : -1, guide });\n    };\n    compute();\n    const offs = ([\"ready\", \"identify\", \"guide:start\", \"guide:step\", \"guide:complete\", \"guide:dismiss\", \"guide:skip\"] as const).map((e) => client.on(e, compute));\n    return () => offs.forEach((off) => off());\n  }, [client, idOrKey]);\n  return state;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,39 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { PublishedGuide, GuidelyOptions, GuidelyUser, GuidelyClient, ChecklistProgressState, GuidelyEvents } from '@guidelytech/sdk-core';
+export { ChecklistProgressState, GuidelyClient, GuidelyEvents, GuidelyOptions, GuidelyUser, PublishedGuide } from '@guidelytech/sdk-core';
+
+interface GuidelyProviderProps extends Omit<GuidelyOptions, "user"> {
+    /** Identify this user as soon as the client is ready; `undefined` resets the identity. */
+    user?: GuidelyUser | null;
+    children?: ReactNode;
+}
+/**
+ * Creates one Guidely client for the subtree. The client is created inside an effect (never
+ * during SSR) and destroyed on unmount, so React Strict Mode's double-invoke is harmless.
+ */
+declare function GuidelyProvider({ children, user, ...options }: GuidelyProviderProps): react.JSX.Element;
+/** A client that ignores every call; returned by `useGuidely()` on the server and before the provider mounts. */
+declare const noopClient: GuidelyClient;
+/** The Guidely client, or a no-op client during SSR / before the provider has mounted. */
+declare function useGuidely(): GuidelyClient;
+/** True once the client has loaded its configuration. */
+declare function useGuidelyReady(): boolean;
+/** Identifies the user whenever the arguments change. */
+declare function useGuidelyIdentify(userId: string | null | undefined, traits?: Record<string, unknown>, account?: GuidelyUser["account"]): void;
+/** Subscribes to a client event for the lifetime of the component. */
+declare function useGuidelyEvent<K extends keyof GuidelyEvents>(event: K, handler: GuidelyEvents[K]): void;
+/** Live checklist progress for a checklist guide (by id or key). */
+declare function useChecklistProgress(idOrKey: string): ChecklistProgressState;
+interface GuideState {
+    /** The guide is currently showing. */
+    active: boolean;
+    completed: boolean;
+    stepId: string | null;
+    stepIndex: number;
+    guide: PublishedGuide | null;
+}
+/** Live state of a guide (by id or key): active, completed, current step. */
+declare function useGuideState(idOrKey: string): GuideState;
+
+export { type GuideState, GuidelyProvider, type GuidelyProviderProps, noopClient, useChecklistProgress, useGuideState, useGuidely, useGuidelyEvent, useGuidelyIdentify, useGuidelyReady };

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { PublishedGuide, GuidelyOptions, GuidelyUser, GuidelyClient, ChecklistProgressState, GuidelyEvents } from '@guidelytech/sdk-core';
+export { ChecklistProgressState, GuidelyClient, GuidelyEvents, GuidelyOptions, GuidelyUser, PublishedGuide } from '@guidelytech/sdk-core';
+
+interface GuidelyProviderProps extends Omit<GuidelyOptions, "user"> {
+    /** Identify this user as soon as the client is ready; `undefined` resets the identity. */
+    user?: GuidelyUser | null;
+    children?: ReactNode;
+}
+/**
+ * Creates one Guidely client for the subtree. The client is created inside an effect (never
+ * during SSR) and destroyed on unmount, so React Strict Mode's double-invoke is harmless.
+ */
+declare function GuidelyProvider({ children, user, ...options }: GuidelyProviderProps): react.JSX.Element;
+/** A client that ignores every call; returned by `useGuidely()` on the server and before the provider mounts. */
+declare const noopClient: GuidelyClient;
+/** The Guidely client, or a no-op client during SSR / before the provider has mounted. */
+declare function useGuidely(): GuidelyClient;
+/** True once the client has loaded its configuration. */
+declare function useGuidelyReady(): boolean;
+/** Identifies the user whenever the arguments change. */
+declare function useGuidelyIdentify(userId: string | null | undefined, traits?: Record<string, unknown>, account?: GuidelyUser["account"]): void;
+/** Subscribes to a client event for the lifetime of the component. */
+declare function useGuidelyEvent<K extends keyof GuidelyEvents>(event: K, handler: GuidelyEvents[K]): void;
+/** Live checklist progress for a checklist guide (by id or key). */
+declare function useChecklistProgress(idOrKey: string): ChecklistProgressState;
+interface GuideState {
+    /** The guide is currently showing. */
+    active: boolean;
+    completed: boolean;
+    stepId: string | null;
+    stepIndex: number;
+    guide: PublishedGuide | null;
+}
+/** Live state of a guide (by id or key): active, completed, current step. */
+declare function useGuideState(idOrKey: string): GuideState;
+
+export { type GuideState, GuidelyProvider, type GuidelyProviderProps, noopClient, useChecklistProgress, useGuideState, useGuidely, useGuidelyEvent, useGuidelyIdentify, useGuidelyReady };

package/dist/index.js

@@ -0,0 +1,134 @@
+"use client";
+
+// src/index.tsx
+import { createGuidely } from "@guidelytech/sdk-core";
+import { createContext, useContext, useEffect, useRef, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+var GuidelyContext = createContext(null);
+function GuidelyProvider({ children, user, ...options }) {
+  const [client, setClient] = useState(null);
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+  const { projectId, environment, apiUrl } = options;
+  useEffect(() => {
+    if (typeof window === "undefined" || !projectId) return;
+    const c = createGuidely({ ...optionsRef.current, projectId, environment, apiUrl });
+    setClient(c);
+    return () => {
+      c.destroy();
+      setClient((cur) => cur === c ? null : cur);
+    };
+  }, [projectId, environment, apiUrl]);
+  const userKey = user ? JSON.stringify([user.id, user.traits ?? null, user.account ?? null]) : "";
+  const hadUser = useRef(false);
+  useEffect(() => {
+    if (!client) return;
+    if (user && user.id) {
+      hadUser.current = true;
+      void client.identify(user.id, user.traits, user.account);
+    } else if (hadUser.current) {
+      hadUser.current = false;
+      client.reset();
+    }
+  }, [client, userKey]);
+  return /* @__PURE__ */ jsx(GuidelyContext.Provider, { value: client, children });
+}
+var NOOP_RESULTS = {
+  init: Promise.resolve(),
+  ready: Promise.resolve(),
+  identify: Promise.resolve(),
+  setAccount: Promise.resolve(),
+  updateTraits: Promise.resolve(),
+  refresh: Promise.resolve(),
+  startGuide: false,
+  getActiveGuide: null,
+  getGuides: [],
+  getChecklistProgress: { completedTaskIds: [], completedAt: null, dismissedAt: null },
+  isGuideCompleted: false,
+  on: () => {
+  },
+  getState: { ready: false, destroyed: false },
+  getContext: null
+};
+var noopClient = new Proxy({}, {
+  get(_target, prop) {
+    if (prop === "options") return { projectId: "" };
+    if (typeof prop !== "string") return void 0;
+    return () => NOOP_RESULTS[prop];
+  }
+});
+function useGuidely() {
+  return useContext(GuidelyContext) ?? noopClient;
+}
+function useGuidelyReady() {
+  const client = useContext(GuidelyContext);
+  const [ready, setReady] = useState(false);
+  useEffect(() => {
+    if (!client) {
+      setReady(false);
+      return;
+    }
+    if (client.getState().ready) setReady(true);
+    return client.on("ready", () => setReady(true));
+  }, [client]);
+  return ready;
+}
+function useGuidelyIdentify(userId, traits, account) {
+  const client = useContext(GuidelyContext);
+  const key = JSON.stringify([userId ?? null, traits ?? null, account ?? null]);
+  useEffect(() => {
+    if (!client || !userId) return;
+    void client.identify(userId, traits, account);
+  }, [client, key]);
+}
+function useGuidelyEvent(event, handler) {
+  const client = useContext(GuidelyContext);
+  const ref = useRef(handler);
+  ref.current = handler;
+  useEffect(() => {
+    if (!client) return;
+    const cb = ((...args) => ref.current(...args));
+    return client.on(event, cb);
+  }, [client, event]);
+}
+function useChecklistProgress(idOrKey) {
+  const client = useContext(GuidelyContext);
+  const [progress, setProgress] = useState({ completedTaskIds: [], completedAt: null, dismissedAt: null });
+  useEffect(() => {
+    if (!client) return;
+    const update = () => setProgress(client.getChecklistProgress(idOrKey));
+    update();
+    const offs = [client.on("ready", update), client.on("identify", update), client.on("checklist:task", update), client.on("checklist:complete", update)];
+    return () => offs.forEach((off) => off());
+  }, [client, idOrKey]);
+  return progress;
+}
+function useGuideState(idOrKey) {
+  const client = useContext(GuidelyContext);
+  const [state, setState] = useState({ active: false, completed: false, stepId: null, stepIndex: -1, guide: null });
+  useEffect(() => {
+    if (!client) return;
+    const matches = (g) => g.id === idOrKey || g.key === idOrKey;
+    const compute = () => {
+      const guide = client.getGuides().find(matches) ?? null;
+      const active = client.getActiveGuide();
+      const s = client.getState().activeGuide;
+      setState({ active: !!active && matches(active), completed: client.isGuideCompleted(idOrKey), stepId: active && matches(active) ? s?.stepId ?? null : null, stepIndex: active && matches(active) ? s?.stepIndex ?? -1 : -1, guide });
+    };
+    compute();
+    const offs = ["ready", "identify", "guide:start", "guide:step", "guide:complete", "guide:dismiss", "guide:skip"].map((e) => client.on(e, compute));
+    return () => offs.forEach((off) => off());
+  }, [client, idOrKey]);
+  return state;
+}
+export {
+  GuidelyProvider,
+  noopClient,
+  useChecklistProgress,
+  useGuideState,
+  useGuidely,
+  useGuidelyEvent,
+  useGuidelyIdentify,
+  useGuidelyReady
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"sourcesContent":["import { createGuidely, type ChecklistProgressState, type GuidelyClient, type GuidelyEvents, type GuidelyOptions, type GuidelyUser, type PublishedGuide } from \"@guidelytech/sdk-core\";\nimport { createContext, useContext, useEffect, useRef, useState, type ReactNode } from \"react\";\n\nexport type { GuidelyClient, GuidelyOptions, GuidelyEvents, GuidelyUser, ChecklistProgressState, PublishedGuide } from \"@guidelytech/sdk-core\";\n\nconst GuidelyContext = createContext<GuidelyClient | null>(null);\n\nexport interface GuidelyProviderProps extends Omit<GuidelyOptions, \"user\"> {\n  /** Identify this user as soon as the client is ready; `undefined` resets the identity. */\n  user?: GuidelyUser | null;\n  children?: ReactNode;\n}\n\n/**\n * Creates one Guidely client for the subtree. The client is created inside an effect (never\n * during SSR) and destroyed on unmount, so React Strict Mode's double-invoke is harmless.\n */\nexport function GuidelyProvider({ children, user, ...options }: GuidelyProviderProps) {\n  const [client, setClient] = useState<GuidelyClient | null>(null);\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  const { projectId, environment, apiUrl } = options;\n\n  useEffect(() => {\n    if (typeof window === \"undefined\" || !projectId) return;\n    const c = createGuidely({ ...optionsRef.current, projectId, environment, apiUrl });\n    setClient(c);\n    return () => {\n      c.destroy();\n      setClient((cur) => (cur === c ? null : cur));\n    };\n  }, [projectId, environment, apiUrl]);\n\n  const userKey = user ? JSON.stringify([user.id, user.traits ?? null, user.account ?? null]) : \"\";\n  const hadUser = useRef(false);\n  useEffect(() => {\n    if (!client) return;\n    if (user && user.id) {\n      hadUser.current = true;\n      void client.identify(user.id, user.traits, user.account);\n    } else if (hadUser.current) {\n      hadUser.current = false;\n      client.reset();\n    }\n  }, [client, userKey]);\n\n  return <GuidelyContext.Provider value={client}>{children}</GuidelyContext.Provider>;\n}\n\nconst NOOP_RESULTS: Record<string, unknown> = {\n  init: Promise.resolve(),\n  ready: Promise.resolve(),\n  identify: Promise.resolve(),\n  setAccount: Promise.resolve(),\n  updateTraits: Promise.resolve(),\n  refresh: Promise.resolve(),\n  startGuide: false,\n  getActiveGuide: null,\n  getGuides: [],\n  getChecklistProgress: { completedTaskIds: [], completedAt: null, dismissedAt: null },\n  isGuideCompleted: false,\n  on: () => {},\n  getState: { ready: false, destroyed: false },\n  getContext: null,\n};\n\n/** A client that ignores every call; returned by `useGuidely()` on the server and before the provider mounts. */\nexport const noopClient: GuidelyClient = new Proxy({} as GuidelyClient, {\n  get(_target, prop) {\n    if (prop === \"options\") return { projectId: \"\" };\n    if (typeof prop !== \"string\") return undefined;\n    return () => NOOP_RESULTS[prop];\n  },\n});\n\n/** The Guidely client, or a no-op client during SSR / before the provider has mounted. */\nexport function useGuidely(): GuidelyClient {\n  return useContext(GuidelyContext) ?? noopClient;\n}\n\n/** True once the client has loaded its configuration. */\nexport function useGuidelyReady(): boolean {\n  const client = useContext(GuidelyContext);\n  const [ready, setReady] = useState(false);\n  useEffect(() => {\n    if (!client) {\n      setReady(false);\n      return;\n    }\n    if (client.getState().ready) setReady(true);\n    return client.on(\"ready\", () => setReady(true));\n  }, [client]);\n  return ready;\n}\n\n/** Identifies the user whenever the arguments change. */\nexport function useGuidelyIdentify(userId: string | null | undefined, traits?: Record<string, unknown>, account?: GuidelyUser[\"account\"]): void {\n  const client = useContext(GuidelyContext);\n  const key = JSON.stringify([userId ?? null, traits ?? null, account ?? null]);\n  useEffect(() => {\n    if (!client || !userId) return;\n    void client.identify(userId, traits, account);\n  }, [client, key]);\n}\n\n/** Subscribes to a client event for the lifetime of the component. */\nexport function useGuidelyEvent<K extends keyof GuidelyEvents>(event: K, handler: GuidelyEvents[K]): void {\n  const client = useContext(GuidelyContext);\n  const ref = useRef(handler);\n  ref.current = handler;\n  useEffect(() => {\n    if (!client) return;\n    const cb = ((...args: unknown[]) => (ref.current as (...a: unknown[]) => void)(...args)) as GuidelyEvents[K];\n    return client.on(event, cb);\n  }, [client, event]);\n}\n\n/** Live checklist progress for a checklist guide (by id or key). */\nexport function useChecklistProgress(idOrKey: string): ChecklistProgressState {\n  const client = useContext(GuidelyContext);\n  const [progress, setProgress] = useState<ChecklistProgressState>({ completedTaskIds: [], completedAt: null, dismissedAt: null });\n  useEffect(() => {\n    if (!client) return;\n    const update = () => setProgress(client.getChecklistProgress(idOrKey));\n    update();\n    const offs = [client.on(\"ready\", update), client.on(\"identify\", update), client.on(\"checklist:task\", update), client.on(\"checklist:complete\", update)];\n    return () => offs.forEach((off) => off());\n  }, [client, idOrKey]);\n  return progress;\n}\n\nexport interface GuideState {\n  /** The guide is currently showing. */\n  active: boolean;\n  completed: boolean;\n  stepId: string | null;\n  stepIndex: number;\n  guide: PublishedGuide | null;\n}\n\n/** Live state of a guide (by id or key): active, completed, current step. */\nexport function useGuideState(idOrKey: string): GuideState {\n  const client = useContext(GuidelyContext);\n  const [state, setState] = useState<GuideState>({ active: false, completed: false, stepId: null, stepIndex: -1, guide: null });\n  useEffect(() => {\n    if (!client) return;\n    const matches = (g: PublishedGuide) => g.id === idOrKey || g.key === idOrKey;\n    const compute = () => {\n      const guide = client.getGuides().find(matches) ?? null;\n      const active = client.getActiveGuide();\n      const s = client.getState().activeGuide;\n      setState({ active: !!active && matches(active), completed: client.isGuideCompleted(idOrKey), stepId: active && matches(active) ? ((s as { stepId?: string | null } | null)?.stepId ?? null) : null, stepIndex: active && matches(active) ? ((s as { stepIndex?: number } | null)?.stepIndex ?? -1) : -1, guide });\n    };\n    compute();\n    const offs = ([\"ready\", \"identify\", \"guide:start\", \"guide:step\", \"guide:complete\", \"guide:dismiss\", \"guide:skip\"] as const).map((e) => client.on(e, compute));\n    return () => offs.forEach((off) => off());\n  }, [client, idOrKey]);\n  return state;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "@guidelytech/react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "React provider and hooks for Guidely",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@guidelytech/sdk-core": "0.2.0",
+    "@guidelytech/shared": "0.2.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.7",
+    "happy-dom": "^17.6.3",
+    "eslint": "^9.39.5",
+    "@eslint/js": "^9.39.5",
+    "typescript-eslint": "^8.46.0",
+    "react": "19.1.10",
+    "react-dom": "19.1.10",
+    "@types/react": "^19.1.0",
+    "@types/react-dom": "^19.1.0",
+    "@testing-library/react": "^16.3.3"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/parmarg/Guidely.git",
+    "directory": "packages/react"
+  },
+  "homepage": "https://github.com/parmarg/Guidely/tree/main/packages/react#readme",
+  "bugs": {
+    "url": "https://github.com/parmarg/Guidely/issues"
+  },
+  "keywords": [
+    "guidely",
+    "product-adoption",
+    "onboarding",
+    "product-tour",
+    "in-app-guidance",
+    "react"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src",
+    "clean": "rm -rf dist"
+  }
 }