@smartmemory/sdk-js 1.4.52 → 1.4.57

package/README.md

@@ -79,6 +79,40 @@ function Dashboard() {
 }
 ```
 
+### Browser analytics (optional)
+
+The analytics entry point is browser-only and intentionally separate from the core and React bindings. Install its optional `posthog-js` peer only in apps that use analytics:
+
+```bash
+npm install posthog-js
+```
+
+```jsx
+import { PostHogProvider } from 'posthog-js/react';
+import {
+  AnalyticsIdentity,
+  createAnalyticsConfig,
+} from '@smartmemory/sdk-js/react/analytics';
+
+const analytics = createAnalyticsConfig({
+  app: 'web',
+  apiKey: import.meta.env.VITE_PUBLIC_POSTHOG_KEY,
+  apiHost: import.meta.env.VITE_PUBLIC_POSTHOG_HOST,
+});
+
+// Keep the existing child passthrough when analytics.apiKey is null.
+const root = analytics.apiKey
+  ? <PostHogProvider apiKey={analytics.apiKey} options={analytics.options}><App /></PostHogProvider>
+  : <App />;
+
+function IdentityAdapter() {
+  const { user, isAuthenticated, workspaceId } = useAuth();
+  return <AnalyticsIdentity {...{ user, isAuthenticated, workspaceId }} />;
+}
+```
+
+This subpath also exports `captureProductEvent`, `captureException`, and `resetAnalytics`. It is not re-exported from `@smartmemory/sdk-js/react`, so non-browser consumers never load PostHog.
+
 ## Entry Points
 
 | Import | Contents |
@@ -86,6 +120,7 @@ function Dashboard() {
 | `@smartmemory/sdk-js` | SmartMemoryClient, AuthCore, TokenManager, all domain APIs, APIError |
 | `@smartmemory/sdk-js/core` | Everything above + BaseAPI, RefreshManager, SSOManager (internal access) |
 | `@smartmemory/sdk-js/react` | SmartMemoryProvider, useAuth, useAuthState, useAuthActions, useSmartMemory, AuthWrapper |
+| `@smartmemory/sdk-js/react/analytics` | Browser-only strict PostHog config, identity, product-event, exception, and reset helpers (optional `posthog-js` peer) |
 | `@smartmemory/sdk-js/fetch` | createAuthFetch, installInterceptor |
 
 ## Configuration

package/dist/{core-D1Y88paM.js → core-D1O9gOZK.js}

@@ -3,7 +3,7 @@ var R = (a) => {
 };
 var k = (a, e, t) => e.has(a) || R("Cannot " + t);
 var g = (a, e, t) => (k(a, e, "read from private field"), t ? t.call(a) : e.get(a)), w = (a, e, t) => e.has(a) ? R("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(a) : e.set(a, t), b = (a, e, t, s) => (k(a, e, "write to private field"), s ? s.call(a, t) : e.set(a, t), t), S = (a, e, t) => (k(a, e, "access private method"), t);
-const U = {
+const A = {
   access: "smart_memory_auth_token",
   refresh: "smart_memory_refresh_token",
   user: "smart_memory_user",
@@ -23,7 +23,7 @@ class C {
    * @param {Object} [options.keys] - Custom storage key names
    */
   constructor({ storage: e = "localStorage", keys: t = {} } = {}) {
-    this.storageType = e, this.keys = { ...U, ...t }, this._memory = { access: null, refresh: null, user: null, tenant: null, team: null };
+    this.storageType = e, this.keys = { ...A, ...t }, this._memory = { access: null, refresh: null, user: null, tenant: null, team: null };
   }
   getAccessToken() {
     return this.storageType === "memory" ? this._memory.access : this._getFromStorage(this.keys.access, y.access);
@@ -191,7 +191,7 @@ l = new WeakMap(), f = new WeakSet(), v = async function() {
   return this.tokenManager.setAccessToken(r.access_token), r.refresh_token && this.tokenManager.setRefreshToken(r.refresh_token), this.onTokenRefreshed(r.access_token), r.access_token;
 };
 const I = "smart_memory_sso_redirect";
-class q {
+class L {
   /**
    * @param {Object} options
    * @param {string} options.webAppUrl - Web app URL for login redirect
@@ -230,7 +230,7 @@ class q {
     }
   }
 }
-class L {
+class q {
   constructor(e) {
     this.mode = e.mode, this.apiBaseUrl = e.apiBaseUrl, this.endpoints = e.endpoints || {}, this.listeners = /* @__PURE__ */ new Set(), this.useCookieAuth = e.useCookieAuth ?? this.mode === "sso", this.apiKey = e.apiKey || null, this.apiKey && (this.mode = "apiKey"), this.tokenManager = new C({
       storage: e.storage || "localStorage",
@@ -247,7 +247,7 @@ class L {
       onRefreshFailed: () => {
         this.clearLocalAuth();
       }
-    }) : this.refreshManager = null, this.mode === "sso" && (this.ssoManager = new q({
+    }) : this.refreshManager = null, this.mode === "sso" && (this.ssoManager = new L({
       webAppUrl: e.webAppUrl,
       allowedHosts: e.allowedRedirectHosts || [],
       tokenManager: this.tokenManager
@@ -286,7 +286,8 @@ class L {
       isAuthenticated: this.isAuthenticated(),
       user: this.currentUser,
       token: this.currentToken,
-      tenantId: this.tokenManager.getTenantId()
+      tenantId: this.tokenManager.getTenantId(),
+      workspaceId: this.tokenManager.getTeamId()
     };
     this.listeners.forEach((t) => {
       try {
@@ -530,6 +531,21 @@ class z {
   constructor(e) {
     this.api = e;
   }
+  /**
+   * Create a memory item.
+   *
+   * Provenance like `retrieved_context_ids` travels inside `metadata` — the storage
+   * layer lifts it onto the server-side MemoryItem; no dedicated option exists
+   * (GRAPH-API-1i wire field added then removed 2026-08-02).
+   *
+   * @param {Object} options
+   * @param {string} options.content - Memory content
+   * @param {string} [options.memoryType='semantic'] - Memory type
+   * @param {Object} [options.metadata] - Additional metadata
+   * @param {boolean} [options.usePipeline=true] - Run the full extraction pipeline
+   * @param {string} [options.profileName] - Pipeline profile, routed server-side
+   * @param {Object} [options.conversationContext] - Conversation-aware extraction context
+   */
   async create({
     content: e,
     memoryType: t = "semantic",
@@ -578,9 +594,31 @@ class z {
   async delete(e) {
     return this.api.delete(`/memory/${e}`);
   }
-  async list({ limit: e = 50, offset: t = 0, type: s = null } = {}) {
-    let r = `/memory/list?limit=${e}&offset=${t}`;
-    return s && (r += `&memory_type=${s}`), this.api.get(r);
+  /**
+   * List memory items, optionally filtered by an exact metadata match.
+   *
+   * @param {object} [options]
+   * @param {number} [options.limit=50]
+   * @param {number} [options.offset=0]
+   * @param {string|null} [options.type=null] - NOTE: sent as `memory_type`, which the
+   *   `/memory/list` route does not declare and therefore ignores. Pre-existing; kept as-is
+   *   so nothing silently changes behaviour for callers already passing it.
+   * @param {string|null} [options.metadataKey=null] - GRAPH-API-1l. Metadata key to filter
+   *   on. Nested keys use dot syntax (`profile.tier`). Must be paired with `metadataValue`;
+   *   sending only one half is a 422.
+   * @param {string|null} [options.metadataValue=null] - Value the key must equal.
+   * @returns {Promise<{items: object[], total: number, limit: number, offset: number}>}
+   *   `total` counts the filtered set, so it drives pagination directly.
+   */
+  async list({
+    limit: e = 50,
+    offset: t = 0,
+    type: s = null,
+    metadataKey: r = null,
+    metadataValue: n = null
+  } = {}) {
+    const i = new URLSearchParams({ limit: e, offset: t });
+    return s && i.append("memory_type", s), r != null && i.append("metadata_key", r), n != null && i.append("metadata_value", n), this.api.get(`/memory/list?${i}`);
   }
   /**
    * Search for memory items.
@@ -611,9 +649,9 @@ class z {
    *   present only under `cite: true`. Pre-LINEAGE-1 callers who indexed into a
    *   bare array must read `response.results` instead.
    */
-  async search(e, { topK: t = 5, enableHybrid: s = !0, memoryType: r = null, expertise: n = !1, cite: i = !1, decompose: o = !1, multiHop: c = !1, maxHops: u = 3, budgetMs: p = 1500, semanticHops: _ = !1, includeReference: $ = !1, includeConsolidated: T = !1, consolidationFirst: A = !1 } = {}) {
+  async search(e, { topK: t = 5, enableHybrid: s = !0, memoryType: r = null, expertise: n = !1, cite: i = !1, decompose: o = !1, multiHop: c = !1, maxHops: u = 3, budgetMs: p = 1500, semanticHops: _ = !1, includeReference: $ = !1, includeConsolidated: T = !1, consolidationFirst: U = !1 } = {}) {
     const m = { query: e, top_k: t, enable_hybrid: s };
-    return r && (m.memory_type = r), n && (m.expertise = !0), i && (m.cite = !0), o && (m.decompose = !0), c && (m.multi_hop = !0), c && u !== 3 && (m.max_hops = u), c && p !== 1500 && (m.budget_ms = p), c && _ && (m.semantic_hops = !0), $ && (m.include_reference = !0), T && (m.include_consolidated = !0), A && (m.consolidation_first = !0), this.api.post("/memory/search", m);
+    return r && (m.memory_type = r), n && (m.expertise = !0), i && (m.cite = !0), o && (m.decompose = !0), c && (m.multi_hop = !0), c && u !== 3 && (m.max_hops = u), c && p !== 1500 && (m.budget_ms = p), c && _ && (m.semantic_hops = !0), $ && (m.include_reference = !0), T && (m.include_consolidated = !0), U && (m.consolidation_first = !0), this.api.post("/memory/search", m);
   }
   async getWorkingContext(e, t, { k: s = 20, maxTokens: r = null, strategy: n = null } = {}) {
     const i = {
@@ -645,9 +683,22 @@ class z {
   async getLinks(e) {
     return this.api.get(`/memory/${e}/links`);
   }
-  async searchByMetadata(e, t, { memoryType: s = null } = {}) {
-    const r = new URLSearchParams({ metadata_key: e, metadata_value: t });
-    return s && r.append("memory_type", s), this.api.get(`/memory/by-metadata?${r}`);
+  /**
+   * Find memory items by exact metadata match.
+   *
+   * @deprecated GRAPH-API-1l — use {@link MemoryAPI#list} with `metadataKey` /
+   *   `metadataValue` instead. It applies the same filter but adds pagination and an
+   *   exact `total`. This method still works and its behaviour is unchanged; the two
+   *   endpoints return slightly different item shapes, so migrate deliberately rather
+   *   than by find-and-replace.
+   */
+  async searchByMetadata(e, t, { memoryType: s = null, limit: r = 25 } = {}) {
+    const n = new URLSearchParams({
+      metadata_key: e,
+      metadata_value: t,
+      limit: r
+    });
+    return s && n.append("memory_type", s), this.api.get(`/memory/by-metadata?${n}`);
   }
   async getNeighbors(e) {
     return this.api.get(`/memory/${e}/neighbors`);
@@ -965,9 +1016,12 @@ class E {
   /**
    * Find existing decisions that may conflict with this one.
    * @param {string} decisionId
+   * @param {number} [minContest=0] - Minimum pairwise contest severity (0..1).
    */
-  async findConflicts(e) {
-    return this.api.post(`/memory/decisions/${e}/conflicts`);
+  async findConflicts(e, t = 0) {
+    return this.api.post(
+      `/memory/decisions/${e}/conflicts?min_contest=${encodeURIComponent(t)}`
+    );
   }
   // --- Legacy reasoning proxies (kept for backward compatibility) ---
   /**
@@ -1059,8 +1113,20 @@ class O {
    * Fetch edges for multiple node IDs in bulk.
    * @param {string[]} nodeIds
    */
-  async getEdgesBulk(e) {
-    return this.api.post("/memory/graph/edges", { node_ids: e });
+  async getEdgesBulk(e, { includeProperties: t = !1 } = {}) {
+    const s = t ? "?include_properties=true" : "";
+    return this.api.post(`/memory/graph/edges${s}`, { node_ids: e });
+  }
+  /**
+   * Bulk upsert graph nodes and edges, optionally replacing a node-ID prefix.
+   * @param {Object} [params]
+   * @param {Array<Object>} [params.nodes=[]] - Nodes with item_id, label, and properties.
+   * @param {Array<Object>} [params.edges=[]] - Edges with source_id, target_id, edge_type, and properties.
+   * @param {string|null} [params.deletePrefix=null] - Scoped node-ID prefix to delete before writing.
+   */
+  async bulkUpsert({ nodes: e = [], edges: t = [], deletePrefix: s = null } = {}) {
+    const r = { nodes: e, edges: t };
+    return s !== null && (r.delete_prefix = s), this.api.post("/memory/graph/bulk", r);
   }
   /**
    * Get Wikipedia grounding status for an entity node.
@@ -1506,7 +1572,7 @@ class J {
     return this.api.get(`/memory/temporal/relationships/${e}/valid-periods`);
   }
 }
-class V {
+class W {
   constructor(e) {
     this.api = e;
   }
@@ -1575,7 +1641,7 @@ class V {
     return this.api.get("/memory/governance/summary");
   }
 }
-class W {
+class V {
   constructor(e) {
     this.api = e;
   }
@@ -2918,9 +2984,9 @@ class oe {
 }
 class me {
   constructor(e) {
-    this.auth = new L(e);
+    this.auth = new q(e);
     const t = new M(this.auth, { fetchFn: e.fetchFn });
-    this._api = t, this.memories = new z(t), this.decisions = new E(t), this.opinions = new x(t), this.graph = new O(t), this.teams = new F(t), this.profiles = new j(t), this.subscriptions = new H(t), this.authAPI = new B(t), this.agents = new K(t), this.usage = new G(t), this.insights = new D(t), this.tokenUsage = new N(t), this.temporal = new J(t), this.governance = new V(t), this.evolution = new W(t), this.reasoning = new Y(t), this.reasoningTraces = new Z(t), this.ontology = new Q(t), this.analytics = new X(t), this.validation = new ee(t), this.pipeline = new te(t), this.archive = new se(t), this.zettelkasten = new re(t), this.procedureMatches = new ne(t), this.procedureCandidates = new ie(t), this.procedureDrift = new ae(t), this.summaries = new oe(t);
+    this._api = t, this.memories = new z(t), this.decisions = new E(t), this.opinions = new x(t), this.graph = new O(t), this.teams = new F(t), this.profiles = new j(t), this.subscriptions = new H(t), this.authAPI = new B(t), this.agents = new K(t), this.usage = new G(t), this.insights = new D(t), this.tokenUsage = new N(t), this.temporal = new J(t), this.governance = new W(t), this.evolution = new V(t), this.reasoning = new Y(t), this.reasoningTraces = new Z(t), this.ontology = new Q(t), this.analytics = new X(t), this.validation = new ee(t), this.pipeline = new te(t), this.archive = new se(t), this.zettelkasten = new re(t), this.procedureMatches = new ne(t), this.procedureCandidates = new ie(t), this.procedureDrift = new ae(t), this.summaries = new oe(t);
   }
   setTeamId(e) {
     this.auth.tokenManager.setTeamId(e), this.auth.notifyListeners();
@@ -2949,8 +3015,8 @@ export {
   h as A,
   M as B,
   E as D,
-  W as E,
-  V as G,
+  V as E,
+  W as G,
   D as I,
   z as M,
   Q as O,
@@ -2965,7 +3031,7 @@ export {
   X as b,
   se as c,
   B as d,
-  L as e,
+  q as e,
   O as f,
   x as g,
   ie as h,
@@ -2977,5 +3043,5 @@ export {
   C as n,
   N as o,
   P as p,
-  q
+  L as q
 };

package/dist/core.js

@@ -1,4 +1,4 @@
-import { A as e, a as r, d as A, e as I, B as P, D as n, f as o, I as t, M as i, j as g, p as M, q as h, S as m, l as S, T as f, n as p, U as l } from "./core-D1Y88paM.js";
+import { A as e, a as r, d as A, e as I, B as P, D as n, f as o, I as t, M as i, j as g, p as M, q as h, S as m, l as S, T as f, n as p, U as l } from "./core-D1O9gOZK.js";
 export {
   e as APIError,
   r as AgentAPI,

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as f, a as u, b as A, c as b, d as P, e as h, D as I, E as g, G as x, f as p, I as w, M as m, O as k, g as v, P as T, h as B, i as y, j as C, R as E, k as S, S as R, l as F, T as M, m as L, n as O, o as G, U, V as $, Z as D } from "./core-D1Y88paM.js";
+import { A as f, a as u, b as A, c as b, d as P, e as h, D as I, E as g, G as x, f as p, I as w, M as m, O as k, g as v, P as T, h as B, i as y, j as C, R as E, k as S, S as R, l as F, T as M, m as L, n as O, o as G, U, V as $, Z as D } from "./core-D1O9gOZK.js";
 const i = {
   variables: {
     colorBackground: "transparent",

package/dist/react/analytics.js

@@ -0,0 +1,228 @@
+import { useEffect as m } from "react";
+import u from "posthog-js";
+function y() {
+  var e;
+  if (typeof import.meta < "u")
+    return "production";
+  if (typeof process < "u")
+    return (e = process.env) == null ? void 0 : e.NODE_ENV;
+}
+function E(e) {
+  return e === "production" || e === "test" ? e : "development";
+}
+const g = /(url|referrer|href)/i;
+function b(e) {
+  if (typeof e != "string" || !/^https?:\/\//i.test(e))
+    return e;
+  try {
+    const t = new URL(e);
+    return `${t.origin}${t.pathname}`;
+  } catch {
+    return null;
+  }
+}
+function p(e) {
+  if (!e || typeof e != "object")
+    return e;
+  const t = Array.isArray(e) ? [...e] : { ...e };
+  for (const [r, n] of Object.entries(t))
+    n && typeof n == "object" ? t[r] = p(n) : g.test(r) && (t[r] = b(n));
+  return t;
+}
+function h(e) {
+  return !e || typeof e != "object" ? e : { ...e, properties: p(e.properties) };
+}
+function U({ app: e, apiKey: t, apiHost: r }) {
+  const n = typeof t == "string" && t.trim() ? t.trim() : null, c = E(y());
+  return {
+    apiKey: n,
+    options: {
+      api_host: r,
+      autocapture: !1,
+      // PostHog's exception autocapture hooks window.onerror / unhandledrejection
+      // and ships the raw message, stack, and filenames — it never passes through
+      // our sanitized captureException seam, so an error string built from a search
+      // query or memory content would be sent verbatim. Explicit capture only.
+      capture_exceptions: !1,
+      capture_pageview: "history_change",
+      cross_subdomain_cookie: !0,
+      defaults: "2025-05-24",
+      // Session replay is ON but fully masked (D3 revision 2026-07-22):
+      // layout/navigation are visible, memory content, search queries, and
+      // chat text are not.
+      //
+      // maskTextSelector: '*' is the load-bearing flag. The top-level
+      // mask_all_text / mask_all_element_attributes options do NOT reach the
+      // recorder — posthog-js reads them only in autocapture.js and
+      // dead-clicks-autocapture.js (see their `maskAllText:` usage). The replay
+      // recorder resolves masking solely from session_recording.{maskAllInputs,
+      // maskTextSelector, blockSelector}. They are kept here as defense in depth
+      // for the autocapture surfaces, which remote config can switch on.
+      disable_session_recording: !1,
+      mask_all_text: !0,
+      mask_all_element_attributes: !0,
+      session_recording: {
+        maskAllInputs: !0,
+        maskTextSelector: "*"
+      },
+      // The PostHog project has consoleLogRecordingEnabled: true server-side, which
+      // pipes console output into the replay. Apps log raw payloads while debugging
+      // (Maya logs recalled memory content), so that is a content channel masking
+      // does not cover. Pin it off from the client, which takes precedence.
+      enable_recording_console_log: !1,
+      // $current_url / $referrer and their $initial_* variants are attached by
+      // PostHog to every event, replay snapshot, and identify — outside the
+      // product-event allowlist. Strip query strings and fragments so record
+      // identifiers cannot ride along.
+      before_send: h,
+      loaded: (i) => {
+        if (!(!n || typeof (i == null ? void 0 : i.register) != "function"))
+          try {
+            i.register({ app: e, environment: c });
+          } catch {
+          }
+      }
+    }
+  };
+}
+function v() {
+  return !u || u.__loaded !== !0 ? null : u;
+}
+function x({ user: e, isAuthenticated: t, workspaceId: r }) {
+  const n = e == null ? void 0 : e.id, c = e == null ? void 0 : e.email, i = e == null ? void 0 : e.subscription_tier, s = e == null ? void 0 : e.tenant_id;
+  return m(() => {
+    var f, _, l, d;
+    const o = v();
+    if (o)
+      try {
+        if (!t || !n) {
+          (f = o.unregister) == null || f.call(o, "workspace_id");
+          return;
+        }
+        r ? (_ = o.register) == null || _.call(o, { workspace_id: r }) : (l = o.unregister) == null || l.call(o, "workspace_id"), (d = o.identify) == null || d.call(o, n, {
+          email: c,
+          plan: i,
+          tenant_id: s
+        });
+      } catch {
+      }
+  }, [c, t, i, s, n, r]), null;
+}
+const z = Object.freeze({
+  evolution_triggered: Object.freeze(["error_count", "evolver_count", "evolver_keys", "executed_count", "profile_present", "skipped_count", "stop_on_error"]),
+  memories_cleared: Object.freeze(["deleted_count", "nuclear"]),
+  memory_created: Object.freeze(["created_count", "failed_count", "has_collection", "memory_type", "profile_present", "source", "tag_count", "use_pipeline"]),
+  memory_deleted: Object.freeze(["memory_type", "operation", "source"]),
+  memory_edited: Object.freeze(["changed_fields", "has_collection", "memory_type", "tag_count", "write_mode"]),
+  search_performed: Object.freeze(["budget_bucket", "cite", "decompose", "hybrid", "max_hops", "memory_type", "min_score_bucket", "multi_hop", "result_count", "semantic_hops", "surface", "top_k"]),
+  studio_pipeline_saved: Object.freeze(["enricher_count", "evolver_count", "grounder_count", "override_key_count", "save_surface", "stage_count", "storage"])
+}), O = Object.freeze({
+  memory_deleted: Object.freeze({
+    source: Object.freeze(["user", "cli", "api", "import", "signup", "managed", "mcp", "pipeline", "hook", "lifecycle", "observe", "evolver", "code", "enricher", "conversation", "structured", "version", "snapshot", "unknown"])
+  }),
+  search_performed: Object.freeze({
+    min_score_bucket: Object.freeze(["lt50", "lt80", "gte80"])
+  })
+}), j = /* @__PURE__ */ new Set([
+  "body",
+  "content",
+  "context",
+  "error",
+  "message",
+  "query",
+  "response",
+  "result",
+  "tag_values",
+  "tags",
+  "url"
+]), k = /* @__PURE__ */ new Set([
+  "AggregateError",
+  "Error",
+  "EvalError",
+  "RangeError",
+  "ReferenceError",
+  "SyntaxError",
+  "TypeError",
+  "URIError"
+]), R = ["source", "component", "operation", "method"];
+function a() {
+  return !u || u.__loaded !== !0 ? null : u;
+}
+function A(e) {
+  return j.has(e) ? !0 : /(^|_)(id|ids|name|names|tag|tags)$/.test(e);
+}
+function S(e, t, r) {
+  var c;
+  const n = (c = O[e]) == null ? void 0 : c[t];
+  return !n || n.includes(r);
+}
+function w(e) {
+  try {
+    return k.has(e == null ? void 0 : e.name) ? e.name : "Error";
+  } catch {
+    return "Error";
+  }
+}
+function N(e) {
+  const t = new Error();
+  return delete t.message, delete t.stack, Object.defineProperty(t, "name", {
+    configurable: !0,
+    enumerable: !0,
+    value: w(e)
+  }), t;
+}
+function T(e) {
+  const t = {};
+  if (!e || typeof e != "object")
+    return t;
+  for (const r of R)
+    typeof e[r] == "string" && (t[r] = e[r]);
+  return typeof e.status == "number" && Number.isFinite(e.status) && (t.status = e.status), t;
+}
+function I(e, t = {}) {
+  const r = z[e], n = a();
+  if (!r || !n || typeof n.capture != "function")
+    return !1;
+  try {
+    const c = {};
+    for (const i of r) {
+      if (A(i))
+        continue;
+      const s = t == null ? void 0 : t[i];
+      s === void 0 || !S(e, i, s) || (c[i] = s);
+    }
+    return n.capture(e, c), !0;
+  } catch {
+    return !1;
+  }
+}
+function D(e, t = {}) {
+  const r = a();
+  if (!r || typeof r.captureException != "function")
+    return !1;
+  try {
+    return r.captureException(
+      N(e),
+      T(t)
+    ), !0;
+  } catch {
+    return !1;
+  }
+}
+function K() {
+  const e = a();
+  if (!e || typeof e.reset != "function")
+    return !1;
+  try {
+    return e.reset(), !0;
+  } catch {
+    return !1;
+  }
+}
+export {
+  x as AnalyticsIdentity,
+  D as captureException,
+  I as captureProductEvent,
+  U as createAnalyticsConfig,
+  K as resetAnalytics
+};

package/dist/react.js

@@ -1,64 +1,66 @@
-import h, { createContext as d, useRef as y, useState as v, useEffect as b, useCallback as c, useContext as f } from "react";
-import { S as x } from "./core-D1Y88paM.js";
-const m = d(null), g = d(null);
-function U({ children: e, ...r }) {
-  const n = y(null);
-  n.current || (n.current = new x(r));
-  const t = n.current, [u, o] = v({
+import h, { createContext as d, useRef as I, useState as p, useEffect as C, useCallback as c, useContext as g } from "react";
+import { S as y } from "./core-D1O9gOZK.js";
+const m = d(null), f = d(null);
+function b({ children: e, ...r }) {
+  const n = I(null);
+  n.current || (n.current = new y(r));
+  const t = n.current, [o, u] = p({
     isAuthenticated: t.auth.isAuthenticated(),
     user: t.auth.getCurrentUser(),
     token: t.auth.getCurrentToken(),
     tenantId: t.auth.getTenantId(),
+    workspaceId: t.auth.tokenManager.getTeamId(),
     loading: !1,
     error: null
   });
-  b(() => t.auth.addListener((a) => {
-    o((C) => ({
-      ...C,
-      isAuthenticated: a.isAuthenticated,
-      user: a.user,
-      token: a.token,
-      tenantId: a.tenantId
+  C(() => t.auth.addListener((i) => {
+    u((k) => ({
+      ...k,
+      isAuthenticated: i.isAuthenticated,
+      user: i.user,
+      token: i.token,
+      tenantId: i.tenantId,
+      workspaceId: i.workspaceId
     }));
   }), [t]);
-  const s = c(async () => {
+  const a = c(async () => {
     await t.auth.logout();
-  }, [t]), A = c((i) => t.auth.hasRole(i), [t]), S = c((i) => t.auth.getLoginUrl(i), [t]), w = {
-    ...u,
-    logout: s,
-    hasRole: A,
-    getLoginUrl: S
+  }, [t]), w = c((s) => t.auth.hasRole(s), [t]), A = c((s) => t.auth.getLoginUrl(s), [t]), S = {
+    ...o,
+    logout: a,
+    hasRole: w,
+    getLoginUrl: A
   };
-  return /* @__PURE__ */ h.createElement(m.Provider, { value: w }, /* @__PURE__ */ h.createElement(g.Provider, { value: t }, e));
+  return /* @__PURE__ */ h.createElement(m.Provider, { value: S }, /* @__PURE__ */ h.createElement(f.Provider, { value: t }, e));
 }
 function l() {
-  const e = f(m);
+  const e = g(m);
   if (!e)
     throw new Error("useAuth must be used within a SmartMemoryProvider");
   return e;
 }
-function k() {
-  const { isAuthenticated: e, user: r, token: n, tenantId: t, loading: u, error: o } = l();
-  return { isAuthenticated: e, user: r, token: n, tenantId: t, loading: u, error: o };
+function x() {
+  const { isAuthenticated: e, user: r, token: n, tenantId: t, workspaceId: o, loading: u, error: a } = l();
+  return { isAuthenticated: e, user: r, token: n, tenantId: t, workspaceId: o, loading: u, error: a };
 }
-function p() {
+function R() {
   const { login: e, logout: r, hasRole: n, getLoginUrl: t } = l();
   return { login: e, logout: r, hasRole: n, getLoginUrl: t };
 }
-function E() {
-  const e = f(g);
+function U() {
+  const e = g(f);
   if (!e)
     throw new Error("useSmartMemory must be used within a SmartMemoryProvider");
   return e;
 }
-function I({ children: e, fallback: r = null, redirectToLogin: n = !1 }) {
-  const { isAuthenticated: t, loading: u, getLoginUrl: o } = l();
-  if (u) return r;
+function E({ children: e, fallback: r = null, redirectToLogin: n = !1 }) {
+  const { isAuthenticated: t, loading: o, getLoginUrl: u } = l();
+  if (o) return r;
   if (!t) {
     if (n)
       try {
-        const s = o();
-        window.location.href = s;
+        const a = u();
+        window.location.href = a;
       } catch {
       }
     return r;
@@ -67,11 +69,11 @@ function I({ children: e, fallback: r = null, redirectToLogin: n = !1 }) {
 }
 export {
   m as AuthContext,
-  I as AuthWrapper,
-  g as ClientContext,
-  U as SmartMemoryProvider,
+  E as AuthWrapper,
+  f as ClientContext,
+  b as SmartMemoryProvider,
   l as useAuth,
-  p as useAuthActions,
-  k as useAuthState,
-  E as useSmartMemory
+  R as useAuthActions,
+  x as useAuthState,
+  U as useSmartMemory
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@smartmemory/sdk-js",
-  "version": "1.4.52",
-  "description": "Unified JavaScript SDK for SmartMemory API — auth + API client for all frontends",
+  "version": "1.4.57",
+  "description": "Unified JavaScript SDK for SmartMemory API \u2014 auth + API client for all frontends",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -18,6 +18,10 @@
       "development": "./src/react/index.js",
       "default": "./dist/react.js"
     },
+    "./react/analytics": {
+      "development": "./src/react/analytics/index.js",
+      "default": "./dist/react/analytics.js"
+    },
     "./fetch": {
       "development": "./src/fetch/index.js",
       "default": "./dist/fetch.js"
@@ -35,13 +39,17 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "lint": "eslint src/ tests/"
+    "lint": "eslint src/ tests/ scripts/"
   },
   "peerDependencies": {
+    "posthog-js": "^1.313.0",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0"
   },
   "peerDependenciesMeta": {
+    "posthog-js": {
+      "optional": true
+    },
     "react": {
       "optional": true
     },
@@ -57,6 +65,7 @@
     "eslint": "^9.0.0",
     "globals": "^16.0.0",
     "jsdom": "^25.0.0",
+    "posthog-js": "^1.313.0",
     "react": "^18.3.0",
     "react-dom": "^18.3.0",
     "vite": "^6.0.0",