@elvix.is/sdk 0.6.1 → 0.6.3

package/dist/react.d.ts

@@ -228,6 +228,17 @@ declare function useElvixApp(): ElvixBootstrapEnvelope | null;
  *  with no clientId, or when there's no user session. */
 declare function useElvixAppContext(): ElvixAppContext | null;
 declare function useElvixContext(): ElvixContextValue;
+/**
+ * Resolve the effective elvix origin for a hook / component:
+ *   1. explicit `propBaseUrl` (caller wins),
+ *   2. `<ElvixProvider baseUrl>` from context if present + non-empty,
+ *   3. public default `"https://elvix.is"`.
+ *
+ * SSR-safe — never touches `window`. Use this in every SDK hook /
+ * component that takes an optional `baseUrl` so a host that wires the
+ * provider once doesn't have to re-thread it through every prop.
+ */
+declare function useResolvedBaseUrl(propBaseUrl?: string): string;
 declare function ElvixProvider({ clientId, theme, brand, baseUrl, children, className, }: {
     clientId?: string;
     theme?: ElvixTheme;
@@ -551,7 +562,9 @@ type UseUserListResult = {
 type Opts = {
     applicationId: string;
     userId: string;
-    /** elvix origin. Defaults to "" (same-origin). */
+    /** elvix origin. Defaults to "https://elvix.is" — the public elvix
+     *  identity host. Override only for self-hosted elvix instances or
+     *  dev mirrors; production consumers never need to pass this. */
     baseUrl?: string;
     /** Poll interval in ms. Default 7000. */
     pollMs?: number;
@@ -561,7 +574,9 @@ declare const useUserScopes: (opts: Opts) => UseUserListResult;
 declare const useUserMemberships: (opts: Opts) => UseUserListResult;
 
 type ElvixLifecycleWatcherProps = {
-    /** elvix origin. Defaults to "" (same-origin). */
+    /** elvix origin. Defaults to "https://elvix.is" — the public elvix
+     *  identity host. Override only for self-hosted elvix instances or
+     *  dev mirrors; production consumers never need to pass this. */
     baseUrl?: string;
     /** Poll interval in ms when SSE isn't available. Default 7000. */
     pollMs?: number;
@@ -1072,4 +1087,4 @@ type ElvixLegalEntitiesProps = {
 };
 declare function ElvixLegalEntities({ height, minHeight, maxHeight, width, onChange, onResult, }: ElvixLegalEntitiesProps): react_jsx_runtime.JSX.Element;
 
-export { DEFAULT_COPY, ElvixAddressBook, type ElvixAppContext, ElvixAvatar, ElvixBanner, type ElvixBootstrapEnvelope, type ElvixBrand, ElvixCard, type ElvixCopy, ElvixDeactivate, ElvixExport, ElvixIdentityForm, ElvixLanguages, ElvixLeave, ElvixLegalEntities, ElvixLifecycleWatcher, ElvixProvider, ElvixRegion, ElvixSecuredBadge, ElvixSessions, ElvixSignIn, ElvixSignInButton, ElvixSignInForm, type ElvixSignInMethod, type ElvixSignInResult$1 as ElvixSignInResult, type ElvixSignInResultErr, type ElvixSignInResultOk, type ElvixSizeProps, type ElvixTheme, ElvixUsername, type UseUserListResult, consumeElvixReturnToken, getElvixToken, setElvixToken, useElvixApp, useElvixAppContext, useElvixContext, useUserMemberships, useUserRoles, useUserScopes };
+export { DEFAULT_COPY, ElvixAddressBook, type ElvixAppContext, ElvixAvatar, ElvixBanner, type ElvixBootstrapEnvelope, type ElvixBrand, ElvixCard, type ElvixCopy, ElvixDeactivate, ElvixExport, ElvixIdentityForm, ElvixLanguages, ElvixLeave, ElvixLegalEntities, ElvixLifecycleWatcher, ElvixProvider, ElvixRegion, ElvixSecuredBadge, ElvixSessions, ElvixSignIn, ElvixSignInButton, ElvixSignInForm, type ElvixSignInMethod, type ElvixSignInResult$1 as ElvixSignInResult, type ElvixSignInResultErr, type ElvixSignInResultOk, type ElvixSizeProps, type ElvixTheme, ElvixUsername, type UseUserListResult, consumeElvixReturnToken, getElvixToken, setElvixToken, useElvixApp, useElvixAppContext, useElvixContext, useResolvedBaseUrl, useUserMemberships, useUserRoles, useUserScopes };

package/dist/react.js

@@ -167,6 +167,12 @@ function useElvixContext() {
   }
   return ctx;
 }
+function useResolvedBaseUrl(propBaseUrl) {
+  const ctx = useContext(ElvixContext);
+  if (propBaseUrl) return propBaseUrl;
+  if (ctx?.baseUrl) return ctx.baseUrl;
+  return DEFAULT_BASE_URL;
+}
 function ElvixProvider({
   clientId,
   theme,
@@ -2609,7 +2615,8 @@ function ElvixSecuredBadge({
 import { useCallback as useCallback4, useEffect as useEffect5, useState as useState7 } from "react";
 var POLL_MS = 7e3;
 function useUserList(kind, opts) {
-  const { applicationId, baseUrl = "", pollMs = POLL_MS } = opts;
+  const { applicationId, pollMs = POLL_MS } = opts;
+  const resolvedBaseUrl = useResolvedBaseUrl(opts.baseUrl);
   const [slugs, setSlugs] = useState7([]);
   const [loading, setLoading] = useState7(true);
   const [error51, setError] = useState7(null);
@@ -2617,7 +2624,7 @@ function useUserList(kind, opts) {
     setError(null);
     try {
       const res = await fetch(
-        `${baseUrl}/api/me/${kind}?applicationId=${encodeURIComponent(applicationId)}`,
+        `${resolvedBaseUrl}/api/me/${kind}?applicationId=${encodeURIComponent(applicationId)}`,
         authInit()
       );
       const json2 = await res.json().catch(() => ({}));
@@ -2631,7 +2638,7 @@ function useUserList(kind, opts) {
     } finally {
       setLoading(false);
     }
-  }, [applicationId, baseUrl, kind]);
+  }, [applicationId, resolvedBaseUrl, kind]);
   useEffect5(() => {
     refresh();
     const id = setInterval(refresh, pollMs);
@@ -2662,12 +2669,13 @@ function isSameOrigin2(baseUrl) {
   }
 }
 function ElvixLifecycleWatcher({
-  baseUrl = "",
+  baseUrl,
   pollMs = 7e3,
   applicationId,
   userId,
   onSignedOut
 }) {
+  const resolvedBaseUrl = useResolvedBaseUrl(baseUrl);
   useEffect6(() => {
     let cancelled = false;
     let fired = false;
@@ -2678,7 +2686,7 @@ function ElvixLifecycleWatcher({
       if (onSignedOut) onSignedOut(reason);
       else if (typeof window !== "undefined") window.location.reload();
     }
-    const canSse = applicationId !== void 0 && userId !== void 0 && typeof window !== "undefined" && typeof EventSource !== "undefined" && isSameOrigin2(baseUrl);
+    const canSse = applicationId !== void 0 && userId !== void 0 && typeof window !== "undefined" && typeof EventSource !== "undefined" && isSameOrigin2(resolvedBaseUrl);
     if (canSse) {
       let onRecord2 = function(rec) {
         if (rec.userId !== userId) return;
@@ -2696,7 +2704,7 @@ function ElvixLifecycleWatcher({
         }
       };
       var onRecord = onRecord2, handle = handle2, handleSnapshot = handleSnapshot2;
-      const url2 = new URL(`${baseUrl}/api/presence/stream`, window.location.origin);
+      const url2 = new URL(`${resolvedBaseUrl}/api/presence/stream`, window.location.origin);
       url2.searchParams.set("applicationId", applicationId);
       url2.searchParams.set("userId", userId);
       const ev = new EventSource(url2.toString());
@@ -2712,7 +2720,7 @@ function ElvixLifecycleWatcher({
     const poll = async () => {
       try {
         const init = authInit();
-        const res = await fetch(`${baseUrl}/api/v1/session`, {
+        const res = await fetch(`${resolvedBaseUrl}/api/v1/session`, {
           method: "POST",
           headers: init.headers,
           credentials: init.credentials
@@ -2729,7 +2737,7 @@ function ElvixLifecycleWatcher({
       cancelled = true;
       clearInterval(id);
     };
-  }, [baseUrl, pollMs, applicationId, userId, onSignedOut]);
+  }, [resolvedBaseUrl, pollMs, applicationId, userId, onSignedOut]);
   return null;
 }
 
@@ -28385,6 +28393,7 @@ export {
   useElvixApp,
   useElvixAppContext,
   useElvixContext,
+  useResolvedBaseUrl,
   useUserMemberships,
   useUserRoles,
   useUserScopes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elvix.is/sdk",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Official elvix SDK. Drop-in React components, server helpers, and an MCP server so AI coding agents integrate elvix on the first try.",
   "license": "MIT",
   "homepage": "https://elvix.is",