ontheway-sdk 0.1.0

package/dist/chunk-OKJ5GEH3.js

@@ -0,0 +1,358 @@
+import { __spreadValues } from './chunk-DDAAVRWG.js';
+import { driver } from 'driver.js';
+
+var DRIVER_CSS_CDN = "https://cdn.jsdelivr.net/npm/driver.js@1.3.1/dist/driver.css";
+function loadDriverCSS() {
+  if (typeof document === "undefined") return;
+  if (document.querySelector("link[data-otw-driver-css]")) return;
+  const link = document.createElement("link");
+  link.rel = "stylesheet";
+  link.href = DRIVER_CSS_CDN;
+  link.setAttribute("data-otw-driver-css", "1");
+  document.head.appendChild(link);
+}
+var CROSS_PAGE_KEY = "otw_active_tour";
+var OnTheWay = class {
+  constructor(config) {
+    this.driverInstance = null;
+    /** Condition functions registered via `registerCondition` */
+    this.conditions = /* @__PURE__ */ new Map();
+    this.config = __spreadValues({
+      apiUrl: "/api"
+    }, config);
+    this.state = {
+      loaded: false,
+      tasks: [],
+      completedTasks: /* @__PURE__ */ new Set()
+    };
+    if (config.driverCssUrl !== false) {
+      if (config.driverCssUrl) {
+        if (typeof document !== "undefined" && !document.querySelector("link[data-otw-driver-css]")) {
+          const link = document.createElement("link");
+          link.rel = "stylesheet";
+          link.href = config.driverCssUrl;
+          link.setAttribute("data-otw-driver-css", "1");
+          document.head.appendChild(link);
+        }
+      } else {
+        loadDriverCSS();
+      }
+    }
+    this.visitorId = this.getOrCreateVisitorId();
+    this.init();
+  }
+  async init() {
+    this.loadCompletedTasks();
+    await this.fetchTasks();
+    this.state.loaded = true;
+    if (!this.resumeCrossPageTour()) {
+      this.handleAutoStart();
+    }
+  }
+  getOrCreateVisitorId() {
+    if (typeof localStorage === "undefined") return "v_ssr";
+    const key = "otw_visitor_id";
+    let id = localStorage.getItem(key);
+    if (!id) {
+      id = "v_" + Math.random().toString(36).substring(2) + Date.now().toString(36);
+      localStorage.setItem(key, id);
+    }
+    return id;
+  }
+  loadCompletedTasks() {
+    if (typeof localStorage === "undefined") return;
+    const key = `otw_completed_${this.config.projectId}`;
+    const completed = localStorage.getItem(key);
+    if (completed) {
+      this.state.completedTasks = new Set(JSON.parse(completed));
+    }
+  }
+  saveCompletedTask(taskId) {
+    this.state.completedTasks.add(taskId);
+    if (typeof localStorage === "undefined") return;
+    const key = `otw_completed_${this.config.projectId}`;
+    localStorage.setItem(key, JSON.stringify([...this.state.completedTasks]));
+  }
+  async fetchTasks() {
+    try {
+      const res = await fetch(`${this.config.apiUrl}/sdk/${this.config.projectId}/config`);
+      if (!res.ok) throw new Error("Failed to fetch config");
+      const data = await res.json();
+      this.state.tasks = data.tasks || [];
+    } catch (error) {
+      console.warn("[OnTheWay] Failed to load config:", error);
+    }
+  }
+  handleAutoStart() {
+    var _a, _b, _c;
+    if (typeof window === "undefined") return;
+    const currentUrl = window.location.href;
+    for (const task of this.state.tasks) {
+      if (this.state.completedTasks.has(task.id)) continue;
+      if ((_a = task.targeting) == null ? void 0 : _a.urlPattern) {
+        const pattern = new RegExp(task.targeting.urlPattern);
+        if (!pattern.test(currentUrl)) continue;
+      }
+      if (task.trigger === "auto") {
+        this.start(task.slug);
+        break;
+      } else if (task.trigger === "first-visit") {
+        if (typeof localStorage === "undefined") continue;
+        const visitKey = `otw_visited_${task.id}`;
+        if (!localStorage.getItem(visitKey)) {
+          localStorage.setItem(visitKey, "true");
+          this.start(task.slug);
+          break;
+        }
+      } else if (task.trigger === "condition") {
+        const conditionFn = (_c = this.conditions.get(task.slug)) != null ? _c : (_b = task.targeting) == null ? void 0 : _b.condition;
+        if (conditionFn && conditionFn()) {
+          this.start(task.slug);
+          break;
+        }
+      }
+    }
+  }
+  // ---- Cross-page tour helpers ----
+  /**
+   * Save cross-page tour state so it survives navigation.
+   * @internal
+   */
+  saveCrossPageState(taskSlug, stepIndex) {
+    if (typeof sessionStorage === "undefined") return;
+    const state = {
+      taskSlug,
+      stepIndex,
+      startedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    sessionStorage.setItem(CROSS_PAGE_KEY, JSON.stringify(state));
+  }
+  /**
+   * Clear cross-page tour state.
+   * @internal
+   */
+  clearCrossPageState() {
+    if (typeof sessionStorage === "undefined") return;
+    sessionStorage.removeItem(CROSS_PAGE_KEY);
+  }
+  /**
+   * Attempt to resume a cross-page tour from sessionStorage.
+   * @returns `true` if a tour was resumed, `false` otherwise.
+   * @internal
+   */
+  resumeCrossPageTour() {
+    if (typeof sessionStorage === "undefined") return false;
+    const raw = sessionStorage.getItem(CROSS_PAGE_KEY);
+    if (!raw) return false;
+    try {
+      const state = JSON.parse(raw);
+      const task = this.state.tasks.find((t) => t.slug === state.taskSlug);
+      if (!task) {
+        this.clearCrossPageState();
+        return false;
+      }
+      this.startAtStep(task, state.stepIndex);
+      return true;
+    } catch (e) {
+      this.clearCrossPageState();
+      return false;
+    }
+  }
+  /**
+   * Check whether a step's URL matches the current page.
+   * @internal
+   */
+  stepUrlMatches(stepUrl) {
+    if (!stepUrl) return true;
+    if (typeof window === "undefined") return true;
+    const current = window.location.pathname + window.location.search;
+    try {
+      const parsed = new URL(stepUrl, window.location.origin);
+      return parsed.pathname === window.location.pathname && parsed.search === window.location.search;
+    } catch (e) {
+      return current === stepUrl;
+    }
+  }
+  /**
+   * Start a task at a specific step index (used for cross-page resume).
+   * @internal
+   */
+  startAtStep(task, fromIndex) {
+    const allSteps = task.steps;
+    const targetStep = allSteps[fromIndex];
+    if ((targetStep == null ? void 0 : targetStep.url) && !this.stepUrlMatches(targetStep.url)) {
+      this.saveCrossPageState(task.slug, fromIndex);
+      window.location.href = targetStep.url;
+      return;
+    }
+    const steps = allSteps.slice(fromIndex).map((step) => ({
+      element: step.element,
+      popover: {
+        title: step.popover.title,
+        description: step.popover.description,
+        side: step.popover.side
+      }
+    }));
+    const totalSteps = allSteps.length;
+    this.driverInstance = driver({
+      showProgress: true,
+      steps,
+      onNextClick: () => {
+        var _a;
+        if (!this.driverInstance) return;
+        const relativeIndex = (_a = this.driverInstance.getActiveIndex()) != null ? _a : 0;
+        const absoluteIndex = fromIndex + relativeIndex + 1;
+        if (absoluteIndex < allSteps.length) {
+          const nextStep = allSteps[absoluteIndex];
+          if (nextStep.url && !this.stepUrlMatches(nextStep.url)) {
+            this.saveCrossPageState(task.slug, absoluteIndex);
+            this.driverInstance.destroy();
+            window.location.href = nextStep.url;
+            return;
+          }
+        }
+        this.driverInstance.moveNext();
+      },
+      onDestroyStarted: () => {
+        var _a, _b, _c, _d, _e, _f;
+        if ((_a = this.driverInstance) == null ? void 0 : _a.hasNextStep()) {
+          const relativeIndex = this.driverInstance.getActiveIndex() || 0;
+          const currentIndex = fromIndex + relativeIndex;
+          (_c = (_b = this.config).onSkip) == null ? void 0 : _c.call(_b, task.id, currentIndex);
+          this.trackCompletion(task.id, currentIndex, totalSteps, false);
+          this.clearCrossPageState();
+        } else {
+          this.saveCompletedTask(task.id);
+          (_e = (_d = this.config).onComplete) == null ? void 0 : _e.call(_d, task.id);
+          this.trackCompletion(task.id, totalSteps, totalSteps, true);
+          this.clearCrossPageState();
+        }
+        (_f = this.driverInstance) == null ? void 0 : _f.destroy();
+      }
+    });
+    this.driverInstance.drive();
+  }
+  /**
+   * Register a condition function for a task slug.
+   * When the task trigger is `'condition'`, this function will be evaluated
+   * during auto-start to decide whether to show the tour.
+   *
+   * @param slug - Task slug to attach the condition to
+   * @param fn - Predicate that returns `true` to trigger the tour
+   */
+  registerCondition(slug, fn) {
+    this.conditions.set(slug, fn);
+  }
+  /**
+   * Re-evaluate conditions and auto-start eligible tasks.
+   * Call this when application state changes (e.g. data loaded) and
+   * condition-based tours should be re-checked.
+   */
+  checkConditions() {
+    this.handleAutoStart();
+  }
+  /**
+   * Start a task by slug or ID
+   */
+  start(slugOrId) {
+    const task = this.state.tasks.find((t) => t.slug === slugOrId || t.id === slugOrId);
+    if (!task) {
+      console.warn(`[OnTheWay] Task not found: ${slugOrId}`);
+      return;
+    }
+    this.startAtStep(task, 0);
+  }
+  /**
+   * Reset a task (allow it to show again)
+   */
+  reset(slugOrId) {
+    const task = this.state.tasks.find((t) => t.slug === slugOrId || t.id === slugOrId);
+    if (task) {
+      this.state.completedTasks.delete(task.id);
+      if (typeof localStorage !== "undefined") {
+        const key = `otw_completed_${this.config.projectId}`;
+        localStorage.setItem(key, JSON.stringify([...this.state.completedTasks]));
+        localStorage.removeItem(`otw_visited_${task.id}`);
+      }
+    }
+  }
+  /**
+   * Reset all tasks for this project
+   */
+  resetAll() {
+    this.state.completedTasks.clear();
+    if (typeof localStorage !== "undefined") {
+      localStorage.removeItem(`otw_completed_${this.config.projectId}`);
+      this.state.tasks.forEach((task) => {
+        localStorage.removeItem(`otw_visited_${task.id}`);
+      });
+    }
+  }
+  async trackCompletion(taskId, stepsCompleted, totalSteps, completed) {
+    try {
+      await fetch(`${this.config.apiUrl}/sdk/track`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          task_id: taskId,
+          visitor_id: this.visitorId,
+          steps_completed: stepsCompleted,
+          total_steps: totalSteps,
+          completed
+        })
+      });
+    } catch (e) {
+    }
+  }
+  /**
+   * Get the project ID this SDK instance was configured with.
+   */
+  getProjectId() {
+    return this.config.projectId;
+  }
+  /**
+   * Check if SDK is loaded
+   */
+  isReady() {
+    return this.state.loaded;
+  }
+  /**
+   * Check if a task has been completed
+   */
+  isTaskCompleted(slugOrId) {
+    const task = this.state.tasks.find((t) => t.slug === slugOrId || t.id === slugOrId);
+    if (!task) return false;
+    return this.state.completedTasks.has(task.id);
+  }
+  /**
+   * Get list of available tasks
+   */
+  getTasks() {
+    return [...this.state.tasks];
+  }
+  /**
+   * Get the set of completed task IDs
+   */
+  getCompletedTaskIds() {
+    return new Set(this.state.completedTasks);
+  }
+  /**
+   * Get pending cross-page tour state, if any.
+   * Useful for the React provider to check on mount.
+   */
+  static getCrossPageState() {
+    if (typeof sessionStorage === "undefined") return null;
+    const raw = sessionStorage.getItem(CROSS_PAGE_KEY);
+    if (!raw) return null;
+    try {
+      return JSON.parse(raw);
+    } catch (e) {
+      return null;
+    }
+  }
+};
+var src_default = OnTheWay;
+
+export { OnTheWay, src_default };
+//# sourceMappingURL=chunk-OKJ5GEH3.js.map
+//# sourceMappingURL=chunk-OKJ5GEH3.js.map

package/dist/chunk-OKJ5GEH3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"chunk-OKJ5GEH3.js","sourcesContent":["/**\n * OnTheWay SDK\n * Lightweight onboarding SDK based on Driver.js\n *\n * Usage:\n * import { OnTheWay } from '@ontheway/sdk'\n * const otw = new OnTheWay({ projectId: 'PROJECT_ID' })\n * otw.start('task-slug')\n */\n\nimport { driver, type Driver, type DriveStep } from 'driver.js'\n\n// ---- Runtime CSS injection ----\n\nconst DRIVER_CSS_CDN = 'https://cdn.jsdelivr.net/npm/driver.js@1.3.1/dist/driver.css'\n\nfunction loadDriverCSS() {\n  if (typeof document === 'undefined') return\n  if (document.querySelector('link[data-otw-driver-css]')) return\n  const link = document.createElement('link')\n  link.rel = 'stylesheet'\n  link.href = DRIVER_CSS_CDN\n  link.setAttribute('data-otw-driver-css', '1')\n  document.head.appendChild(link)\n}\n\n// ---- Cross-page Tour Storage ----\n\n/** @internal Key used in sessionStorage for persisting active cross-page tour state */\nconst CROSS_PAGE_KEY = 'otw_active_tour'\n\n/**\n * State persisted to sessionStorage so a tour can survive page navigations.\n */\nexport interface CrossPageTourState {\n  /** Task slug that is currently running */\n  taskSlug: string\n  /** Index of the step to resume from */\n  stepIndex: number\n  /** ISO timestamp when the tour started */\n  startedAt: string\n}\n\n// ---- Types ----\n\n/** Configuration passed to the OnTheWay constructor */\nexport interface OnTheWayConfig {\n  projectId: string\n  apiUrl?: string\n  /** Custom Driver.js CSS URL. Set to `false` to disable auto-injection. */\n  driverCssUrl?: string | false\n  onComplete?: (taskId: string) => void\n  onSkip?: (taskId: string, stepIndex: number) => void\n}\n\n/** A single task returned by the server or configured locally */\nexport interface TaskConfig {\n  id: string\n  slug: string\n  trigger: 'auto' | 'manual' | 'first-visit' | 'condition'\n  steps: StepConfig[]\n  targeting?: {\n    urlPattern?: string\n    newUsersOnly?: boolean\n    /**\n     * Condition callback evaluated at auto-start time.\n     * Return `true` to trigger the tour.\n     * Only used when `trigger === 'condition'`.\n     */\n    condition?: () => boolean\n  }\n}\n\n/** Configuration for a single step in a tour */\nexport interface StepConfig {\n  element: string\n  popover: {\n    title: string\n    description: string\n    side?: 'top' | 'bottom' | 'left' | 'right'\n  }\n  /**\n   * Optional URL this step should be shown on.\n   * If the current page does not match, the SDK will navigate to it and\n   * resume the tour aftehe page loads.\n   */\n  url?: string\n}\n\n/** @internal Runtime state of the SDK */\nexport interface SDKState {\n  loaded: boolean\n  tasks: TaskConfig[]\n  completedTasks: Set<string>\n}\n\nexport class OnTheWay {\n  private config: OnTheWayConfig\n  private state: SDKState\n  private driverInstance: Driver | null = null\n  private visitorId: string\n  /** Condition functions registered via `registerCondition` */\n  private conditions: Map<string, () => boolean> = new Map()\n\n  constructor(config: OnTheWayConfig) {\n    this.config = {\n      apiUrl: '/api',\n      ...config,\n    }\n    this.state = {\n      loaded: false,\n      tasks: [],\n      completedTasks: new Set(),\n    }\n\n    // Inject driver.js CSS at runtime (unless explicitly disabled)\n    if (config.driverCssUrl !== false) {\n      if (config.driverCssUrl) {\n        // User provided a custom CSS URL\n        if (typeof document !== 'undefined' && !document.querySelector('link[data-otw-driver-css]')) {\n          const link = document.createElement('link')\n          link.rel = 'stylesheet'\n          link.href = config.driverCssUrl\n          link.setAttribute('data-otw-driver-css', '1')\n          document.head.appendChild(link)\n        }\n      } else {\n        loadDriverCSS()\n      }\n    }\n\n    this.visitorId = this.getOrCreateVisitorId()\n    this.init()\n  }\n\n  private async init() {\n    // Load completed tasks from localStorage\n    this.loadCompletedTasks()\n\n    // Fetch task configs\n    await this.fetchTasks()\n\n    this.state.loaded = true\n\n    // Check for cross-page tour resume before auto-start\n    if (!this.resumeCrossPageTour()) {\n      // Auto-start tasks if configured\n      this.handleAutoStart()\n    }\n  }\n\n  private getOrCreateVisitorId(): string {\n    if (typeof localStorage === 'undefined') return 'v_ssr'\n    const key = 'otw_visitor_id'\n    let id = localStorage.getItem(key)\n    if (!id) {\n      id = 'v_' + Math.random().toString(36).substring(2) + Date.now().toString(36)\n      localStorage.setItem(key, id)\n    }\n    return id\n  }\n\n  private loadCompletedTasks() {\n    if (typeof localStorage === 'undefined') return\n    const key = `otw_completed_${this.config.projectId}`\n    const completed = localStorage.getItem(key)\n    if (completed) {\n      this.state.completedTasks = new Set(JSON.parse(completed))\n    }\n  }\n\n  private saveCompletedTask(taskId: string) {\n    this.state.completedTasks.add(taskId)\n    if (typeof localStorage === 'undefined') return\n    const key = `otw_completed_${this.config.projectId}`\n    localStorage.setItem(key, JSON.stringify([...this.state.completedTasks]))\n  }\n\n  private async fetchTasks() {\n    try {\n      const res = await fetch(`${this.config.apiUrl}/sdk/${this.config.projectId}/config`)\n      if (!res.ok) throw new Error('Failed to fetch config')\n      const data = await res.json()\n      this.state.tasks = data.tasks || []\n    } catch (error) {\n      console.warn('[OnTheWay] Failed to load config:', error)\n    }\n  }\n\n  private handleAutoStart() {\n    if (typeof window === 'undefined') return\n    const currentUrl = window.location.href\n\n    for (const task of this.state.tasks) {\n      // Skip completed tasks\n      if (this.state.completedTasks.has(task.id)) continue\n\n      // Check URL targeting\n      if (task.targeting?.urlPattern) {\n        const pattern = new RegExp(task.targeting.urlPattern)\n        if (!pattern.test(currentUrl)) continue\n      }\n\n      // Handle trigger types\n      if (task.trigger === 'auto') {\n        this.start(task.slug)\n        break // Only one auto task at a time\n      } else if (task.trigger === 'first-visit') {\n        if (typeof localStorage === 'undefined') continue\n        const visitKey = `otw_visited_${task.id}`\n        if (!localStorage.getItem(visitKey)) {\n          localStorage.setItem(visitKey, 'true')\n          this.start(task.slug)\n          break\n        }\n      } else if (task.trigger === 'condition') {\n        // Check registered condition or inline condition\n        const conditionFn =\n          this.conditions.get(task.slug) ?? task.targeting?.condition\n        if (conditionFn && conditionFn()) {\n          this.start(task.slug)\n          break\n        }\n      }\n    }\n  }\n\n  // ---- Cross-page tour helpers ----\n\n  /**\n   * Save cross-page tour state so it survives navigation.\n   * @internal\n   */\n  private saveCrossPageState(taskSlug: string, stepIndex: number) {\n    if (typeof sessionStorage === 'undefined') return\n    const state: CrossPageTourState = {\n      taskSlug,\n      stepIndex,\n      startedAt: new Date().toISOString(),\n    }\n    sessionStorage.setItem(CROSS_PAGE_KEY, JSON.stringify(state))\n  }\n\n  /**\n   * Clear cross-page tour state.\n   * @internal\n   */\n  private clearCrossPageState() {\n    if (typeof sessionStorage === 'undefined') return\n    sessionStorage.removeItem(CROSS_PAGE_KEY)\n  }\n\n  /**\n   * Attempt to resume a cross-page tour from sessionStorage.\n   * @returns `true` if a tour was resumed, `false` otherwise.\n   * @internal\n   */\n  private resumeCrossPageTour(): boolean {\n    if (typeof sessionStorage === 'undefined') return false\n    const raw = sessionStorage.getItem(CROSS_PAGE_KEY)\n    if (!raw) return false\n\n    try {\n      const state: CrossPageTourState = JSON.parse(raw)\n      const task = this.state.tasks.find(t => t.slug === state.taskSlug)\n      if (!task) {\n        this.clearCrossPageState()\n        return false\n      }\n      // Resume from the saved step index\n      this.startAtStep(task, state.stepIndex)\n      return true\n    } catch {\n      this.clearCrossPageState()\n      return false\n    }\n  }\n\n  /**\n   * Check whether a step's URL matches the current page.\n   * @internal\n   */\n  private stepUrlMatches(stepUrl: string | undefined): boolean {\n    if (!stepUrl) return true // no url constraint = always matches\n    if (typeof window === 'undefined') return true\n    const current = window.location.pathname + window.location.search\n    // Support both full URLs and path-only\n    try {\n      const parsed = new URL(stepUrl, window.location.origin)\n      return (\n        parsed.pathname === window.location.pathname &&\n        parsed.search === window.location.search\n      )\n    } catch {\n      return current === stepUrl\n    }\n  }\n\n  /**\n   * Start a task at a specific step index (used for cross-page resume).\n   * @internal\n   */\n  private startAtStep(task: TaskConfig, fromIndex: number) {\n    const allSteps = task.steps\n\n    // Check if the target step's URL matches the current page\n    const targetStep = allSteps[fromIndex]\n    if (targetStep?.url && !this.stepUrlMatches(targetStep.url)) {\n      // Need to navigate — save state and redirect\n      this.saveCrossPageState(task.slug, fromIndex)\n      window.location.href = targetStep.url\n      return\n    }\n\n    // Build Driver.js steps from fromIndex onward\n    const steps: DriveStep[] = allSteps.slice(fromIndex).map(step => ({\n      element: step.element,\n      popover: {\n        title: step.popover.title,\n        description: step.popover.description,\n        side: step.popover.side,\n      },\n    }))\n\n    const totalSteps = allSteps.length\n\n    this.driverInstance = driver({\n      showProgress: true,\n      steps,\n      onNextClick: () => {\n        if (!this.driverInstance) return\n        const relativeIndex = this.driverInstance.getActiveIndex() ?? 0\n        const absoluteIndex = fromIndex + relativeIndex + 1\n\n        // Check if next step requires a different page\n        if (absoluteIndex < allSteps.length) {\n          const nextStep = allSteps[absoluteIndex]\n          if (nextStep.url && !this.stepUrlMatches(nextStep.url)) {\n            this.saveCrossPageState(task.slug, absoluteIndex)\n            this.driverInstance.destroy()\n            window.location.href = nextStep.url\n            return\n          }\n        }\n\n        this.driverInstance.moveNext()\n      },\n      onDestroyStarted: () => {\n        if (this.driverInstance?.hasNextStep()) {\n          // Skipped\n          const relativeIndex = this.driverInstance.getActiveIndex() || 0\n          const currentIndex = fromIndex + relativeIndex\n          this.config.onSkip?.(task.id, currentIndex)\n          this.trackCompletion(task.id, currentIndex, totalSteps, false)\n          this.clearCrossPageState()\n        } else {\n          // Completed\n          this.saveCompletedTask(task.id)\n          this.config.onComplete?.(task.id)\n          this.trackCompletion(task.id, totalSteps, totalSteps, true)\n          this.clearCrossPageState()\n        }\n        this.driverInstance?.destroy()\n      },\n    })\n\n    this.driverInstance.drive()\n  }\n\n  /**\n   * Register a condition function for a task slug.\n   * When the task trigger is `'condition'`, this function will be evaluated\n   * during auto-start to decide whether to show the tour.\n   *\n   * @param slug - Task slug to attach the condition to\n   * @param fn - Predicate that returns `true` to trigger the tour\n   */\n  public registerCondition(slug: string, fn: () => boolean) {\n    this.conditions.set(slug, fn)\n  }\n\n  /**\n   * Re-evaluate conditions and auto-start eligible tasks.\n   * Call this when application state changes (e.g. data loaded) and\n   * condition-based tours should be re-checked.\n   */\n  public checkConditions() {\n    this.handleAutoStart()\n  }\n\n  /**\n   * Start a task by slug or ID\n   */\n  public start(slugOrId: string) {\n    const task = this.state.tasks.find(t => t.slug === slugOrId || t.id === slugOrId)\n    if (!task) {\n      console.warn(`[OnTheWay] Task not found: ${slugOrId}`)\n      return\n    }\n\n    this.startAtStep(task, 0)\n  }\n\n  /**\n   * Reset a task (allow it to show again)\n   */\n  public reset(slugOrId: string) {\n    const task = this.state.tasks.find(t => t.slug === slugOrId || t.id === slugOrId)\n    if (task) {\n      this.state.completedTasks.delete(task.id)\n      if (typeof localStorage !== 'undefined') {\n        const key = `otw_completed_${this.config.projectId}`\n        localStorage.setItem(key, JSON.stringify([...this.state.completedTasks]))\n        // Also reset first-visit flag\n        localStorage.removeItem(`otw_visited_${task.id}`)\n      }\n    }\n  }\n\n  /**\n   * Reset all tasks for this project\n   */\n  public resetAll() {\n    this.state.completedTasks.clear()\n    if (typeof localStorage !== 'undefined') {\n      localStorage.removeItem(`otw_completed_${this.config.projectId}`)\n      this.state.tasks.forEach(task => {\n        localStorage.removeItem(`otw_visited_${task.id}`)\n      })\n    }\n  }\n\n  private async trackCompletion(\n    taskId: string,\n    stepsCompleted: number,\n    totalSteps: number,\n    completed: boolean,\n  ) {\n    try {\n      await fetch(`${this.config.apiUrl}/sdk/track`, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({\n          task_id: taskId,\n          visitor_id: this.visitorId,\n          steps_completed: stepsCompleted,\n          total_steps: totalSteps,\n          completed,\n        }),\n      })\n    } catch {\n      // Silent fail for analytics\n    }\n  }\n\n  /**\n   * Get the project ID this SDK instance was configured with.\n   */\n  public getProjectId(): string {\n    return this.config.projectId\n  }\n\n  /**\n   * Check if SDK is loaded\n   */\n  public isReady(): boolean {\n    return this.state.loaded\n  }\n\n  /**\n   * Check if a task has been completed\n   */\n  public isTaskCompleted(slugOrId: string): boolean {\n    const task = this.state.tasks.find(t => t.slug === slugOrId || t.id === slugOrId)\n    if (!task) return false\n    return this.state.completedTasks.has(task.id)\n  }\n\n  /**\n   * Get list of available tasks\n   */\n  public getTasks(): TaskConfig[] {\n    return [...this.state.tasks]\n  }\n\n  /**\n   * Get the set of completed task IDs\n   */\n  public getCompletedTaskIds(): Set<string> {\n    return new Set(this.state.completedTasks)\n  }\n\n  /**\n   * Get pending cross-page tour state, if any.\n   * Useful for the React provider to check on mount.\n   */\n  public static getCrossPageState(): CrossPageTourState | null {\n    if (typeof sessionStorage === 'undefined') return null\n    const raw = sessionStorage.getItem(CROSS_PAGE_KEY)\n    if (!raw) return null\n    try {\n      return JSON.parse(raw)\n    } catch {\n      return null\n    }\n  }\n}\n\nexport default OnTheWay\n"]}

package/dist/chunk-RNQLNLNI.js

@@ -0,0 +1,91 @@
+import { OnTheWay } from './chunk-OKJ5GEH3.js';
+import { createContext, useState, useEffect, useCallback, useContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+var OnTheWayContext = createContext({
+  otw: null,
+  ready: false,
+  start: () => {
+  },
+  reset: () => {
+  },
+  resetAll: () => {
+  },
+  registerCondition: () => {
+  },
+  checkConditions: () => {
+  },
+  isTaskCompleted: () => false
+});
+function OnTheWayProvider({
+  projectId,
+  apiUrl,
+  onComplete,
+  onSkip,
+  children
+}) {
+  const [otw, setOtw] = useState(null);
+  const [ready, setReady] = useState(false);
+  useEffect(() => {
+    const instance = new OnTheWay({
+      projectId,
+      apiUrl,
+      onComplete,
+      onSkip
+    });
+    setOtw(instance);
+    const check = setInterval(() => {
+      if (instance.isReady()) {
+        setReady(true);
+        clearInterval(check);
+      }
+    }, 100);
+    return () => {
+      clearInterval(check);
+    };
+  }, [projectId, apiUrl]);
+  const start = useCallback(
+    (slugOrId) => otw == null ? void 0 : otw.start(slugOrId),
+    [otw]
+  );
+  const reset = useCallback(
+    (slugOrId) => otw == null ? void 0 : otw.reset(slugOrId),
+    [otw]
+  );
+  const resetAll = useCallback(() => otw == null ? void 0 : otw.resetAll(), [otw]);
+  const registerCondition = useCallback(
+    (slug, fn) => otw == null ? void 0 : otw.registerCondition(slug, fn),
+    [otw]
+  );
+  const checkConditions = useCallback(() => otw == null ? void 0 : otw.checkConditions(), [otw]);
+  const isTaskCompleted = useCallback(
+    (slugOrId) => {
+      var _a;
+      return (_a = otw == null ? void 0 : otw.isTaskCompleted(slugOrId)) != null ? _a : false;
+    },
+    [otw]
+  );
+  return /* @__PURE__ */ jsx(
+    OnTheWayContext.Provider,
+    {
+      value: {
+        otw,
+        ready,
+        start,
+        reset,
+        resetAll,
+        registerCondition,
+        checkConditions,
+        isTaskCompleted
+      },
+      children
+    }
+  );
+}
+function useOnTheWay() {
+  return useContext(OnTheWayContext);
+}
+
+export { OnTheWayProvider, useOnTheWay };
+//# sourceMappingURL=chunk-RNQLNLNI.js.map
+//# sourceMappingURL=chunk-RNQLNLNI.js.map

package/dist/chunk-RNQLNLNI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.tsx"],"names":[],"mappings":"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","file":"chunk-RNQLNLNI.js","sourcesContent":["'use client'\n\nimport { createContext, useContext, useEffect, useState, useCallback, useRef, type ReactNode } from 'react'\nimport { OnTheWay } from './index'\n\n// ---- Types ----\n\n/** Context value exposed by the OnTheWay provider */\nexport interface OnTheWayContextValue {\n  /** SDK instance, null before initialisation */\n  otw: OnTheWay | null\n  /** Whether the SDK has finished loading */\n  ready: boolean\n  /** Start a tour by slug or ID */\n  start: (slugOrId: string) => void\n  /** Reset a specific task */\n  reset: (slugOrId: string) => void\n  /** Reset all tasks */\n  resetAll: () => void\n  /**\n   * Register a condition function for conditional triggers.\n   * The function is evaluated during auto-start when the task trigger is `'condition'`.\n   */\n  registerCondition: (slug: string, fn: () => boolean) => void\n  /**\n   * Re-evaluate conditions and start eligible tours.\n   * Call after state changes that might satisfy a condition.\n   */\n  checkConditions: () => void\n  /** Check whether a given task has been completed */\n  isTaskCompleted: (slugOrId: string) => boolean\n}\n\n/** Props for the OnTheWayProvider component */\nexport interface OnTheWayProviderProps {\n  projectId: string\n  apiUrl?: string\n  onComplete?: (taskId: string) => void\n  onSkip?: (taskId: string, stepIndex: number) => void\n  children: ReactNode\n}\n\n// ---- Context ----\n\nconst OnTheWayContext = createContext<OnTheWayContextValue>({\n  otw: null,\n  ready: false,\n  start: () => {},\n  reset: () => {},\n  resetAll: () => {},\n  registerCondition: () => {},\n  checkConditions: () => {},\n  isTaskCompleted: () => false,\n})\n\n// ---- Provider ----\n\n/**\n * Provides the OnTheWay SDK to descendant components.\n *\n * Wrap your application (or a subtree) with this provider so that\n * `useOnTheWay()` returns the SDK instance.\n *\n * On mount the provider also checks for any pending cross-page tour\n * (persisted in `sessionStorage`) and resumes it automatically.\n *\n * @example\n * ```tsx\n * <OnTheWayProvider projectId=\"proj_abc\">\n *   <App />\n * </OnTheWayProvider>\n * ```\n */\nexport function OnTheWayProvider({\n  projectId,\n  apiUrl,\n  onComplete,\n  onSkip,\n  children,\n}: OnTheWayProviderProps) {\n  const [otw, setOtw] = useState<OnTheWay | null>(null)\n  const [ready, setReady] = useState(false)\n\n  useEffect(() => {\n    const instance = new OnTheWay({\n      projectId,\n      apiUrl,\n      onComplete,\n      onSkip,\n    })\n\n    setOtw(instance)\n\n    // Poll until ready (cross-page resume happens inside init)\n    const check = setInterval(() => {\n      if (instance.isReady()) {\n        setReady(true)\n        clearInterval(check)\n      }\n    }, 100)\n\n    return () => {\n      clearInterval(check)\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [projectId, apiUrl])\n\n  const start = useCallback(\n    (slugOrId: string) => otw?.start(slugOrId),\n    [otw],\n  )\n\n  const reset = useCallback(\n    (slugOrId: string) => otw?.reset(slugOrId),\n    [otw],\n  )\n\n  const resetAll = useCallback(() => otw?.resetAll(), [otw])\n\n  const registerCondition = useCallback(\n    (slug: string, fn: () => boolean) => otw?.registerCondition(slug, fn),\n    [otw],\n  )\n\n  const checkConditions = useCallback(() => otw?.checkConditions(), [otw])\n\n  const isTaskCompleted = useCallback(\n    (slugOrId: string) => otw?.isTaskCompleted(slugOrId) ?? false,\n    [otw],\n  )\n\n  return (\n    <OnTheWayContext.Provider\n      value={{\n        otw,\n        ready,\n        start,\n        reset,\n        resetAll,\n        registerCondition,\n        checkConditions,\n        isTaskCompleted,\n      }}\n    >\n      {children}\n    </OnTheWayContext.Provider>\n  )\n}\n\n// ---- Hook ----\n\n/**\n * Access the OnTheWay SDK from any component wrapped by `<OnTheWayProvider>`.\n *\n * @example\n * ```tsx\n * function HelpButton() {\n *   const { start } = useOnTheWay()\n *   return <button onClick={() => start('welcome')}>Help</button>\n * }\n * ```\n */\nexport function useOnTheWay() {\n  return useContext(OnTheWayContext)\n}\n"]}