@vaultix.ai/react 0.3.1 → 0.3.2

package/dist/index.d.mts

@@ -42,6 +42,22 @@ interface VaultixSession {
     expiresAt: number;
     claims: SessionClaims;
 }
+interface ConnectPlatformOptions {
+    /** OAuth scopes to request. Joined by the provider's delimiter (space or comma). */
+    scopes?: string[];
+    /**
+     * Meta-specific: a Login Config ID registered on the Vaultix Meta app.
+     * When provided, takes precedence over `scopes` (Meta's rule).
+     */
+    configId?: string;
+    /**
+     * Extra provider-specific params forwarded to the authorization URL.
+     * e.g. { shop: "mystore.myshopify.com" } for Shopify.
+     */
+    extraParams?: Record<string, string>;
+    /** Where to redirect after the user authorizes. Defaults to current page. */
+    redirectUrl?: string;
+}
 interface VaultixContextValue {
     user: VaultixUser | null;
     session: VaultixSession | null;
@@ -49,6 +65,13 @@ interface VaultixContextValue {
     isLoaded: boolean;
     isSignedIn: boolean;
     signOut: () => Promise<void>;
+    /**
+     * Initiate a platform OAuth connection flow (posting, reading, etc.).
+     * Redirects the user to the provider's authorization page via Vaultix.
+     * On completion, Vaultix redirects back with `__vaultix_connect` + `provider`
+     * query params that your app exchanges via POST /oauth/{provider}/connect-complete.
+     */
+    connectPlatform: (provider: string, options?: ConnectPlatformOptions) => void;
 }
 interface VaultixProviderProps {
     publishableKey: string;
@@ -149,4 +172,9 @@ interface OrganizationSwitcherProps {
 }
 declare function OrganizationSwitcher({ afterSwitchUrl, className, }: OrganizationSwitcherProps): react_jsx_runtime.JSX.Element | null;
 
-export { type ChallengeType, OrganizationSwitcher, RedirectToSignIn, RedirectToSignUp, type RiskLevel, type SessionClaims, SignIn, SignUp, SignedIn, SignedOut, UserButton, type VaultixContextValue, type VaultixOrganization, VaultixProvider, type VaultixProviderProps, type VaultixSession, type VaultixUser, useAuth, useOrganization, useSession, useUser, useVaultix };
+/** Returns the stored session JWT, or null if not signed in. */
+declare function getStoredToken(): string | null;
+/** Clears the stored session JWT. Call on 401 so the user is prompted to sign in again. */
+declare function clearStoredToken(): void;
+
+export { type ChallengeType, type ConnectPlatformOptions, OrganizationSwitcher, RedirectToSignIn, RedirectToSignUp, type RiskLevel, type SessionClaims, SignIn, SignUp, SignedIn, SignedOut, UserButton, type VaultixContextValue, type VaultixOrganization, VaultixProvider, type VaultixProviderProps, type VaultixSession, type VaultixUser, clearStoredToken, getStoredToken, useAuth, useOrganization, useSession, useUser, useVaultix };

package/dist/index.d.ts

@@ -42,6 +42,22 @@ interface VaultixSession {
     expiresAt: number;
     claims: SessionClaims;
 }
+interface ConnectPlatformOptions {
+    /** OAuth scopes to request. Joined by the provider's delimiter (space or comma). */
+    scopes?: string[];
+    /**
+     * Meta-specific: a Login Config ID registered on the Vaultix Meta app.
+     * When provided, takes precedence over `scopes` (Meta's rule).
+     */
+    configId?: string;
+    /**
+     * Extra provider-specific params forwarded to the authorization URL.
+     * e.g. { shop: "mystore.myshopify.com" } for Shopify.
+     */
+    extraParams?: Record<string, string>;
+    /** Where to redirect after the user authorizes. Defaults to current page. */
+    redirectUrl?: string;
+}
 interface VaultixContextValue {
     user: VaultixUser | null;
     session: VaultixSession | null;
@@ -49,6 +65,13 @@ interface VaultixContextValue {
     isLoaded: boolean;
     isSignedIn: boolean;
     signOut: () => Promise<void>;
+    /**
+     * Initiate a platform OAuth connection flow (posting, reading, etc.).
+     * Redirects the user to the provider's authorization page via Vaultix.
+     * On completion, Vaultix redirects back with `__vaultix_connect` + `provider`
+     * query params that your app exchanges via POST /oauth/{provider}/connect-complete.
+     */
+    connectPlatform: (provider: string, options?: ConnectPlatformOptions) => void;
 }
 interface VaultixProviderProps {
     publishableKey: string;
@@ -149,4 +172,9 @@ interface OrganizationSwitcherProps {
 }
 declare function OrganizationSwitcher({ afterSwitchUrl, className, }: OrganizationSwitcherProps): react_jsx_runtime.JSX.Element | null;
 
-export { type ChallengeType, OrganizationSwitcher, RedirectToSignIn, RedirectToSignUp, type RiskLevel, type SessionClaims, SignIn, SignUp, SignedIn, SignedOut, UserButton, type VaultixContextValue, type VaultixOrganization, VaultixProvider, type VaultixProviderProps, type VaultixSession, type VaultixUser, useAuth, useOrganization, useSession, useUser, useVaultix };
+/** Returns the stored session JWT, or null if not signed in. */
+declare function getStoredToken(): string | null;
+/** Clears the stored session JWT. Call on 401 so the user is prompted to sign in again. */
+declare function clearStoredToken(): void;
+
+export { type ChallengeType, type ConnectPlatformOptions, OrganizationSwitcher, RedirectToSignIn, RedirectToSignUp, type RiskLevel, type SessionClaims, SignIn, SignUp, SignedIn, SignedOut, UserButton, type VaultixContextValue, type VaultixOrganization, VaultixProvider, type VaultixProviderProps, type VaultixSession, type VaultixUser, clearStoredToken, getStoredToken, useAuth, useOrganization, useSession, useUser, useVaultix };

package/dist/index.js

@@ -29,6 +29,8 @@ __export(index_exports, {
   SignedOut: () => SignedOut,
   UserButton: () => UserButton,
   VaultixProvider: () => VaultixProvider,
+  clearStoredToken: () => clearStoredToken,
+  getStoredToken: () => getStoredToken,
   useAuth: () => useAuth,
   useOrganization: () => useOrganization,
   useSession: () => useSession,
@@ -221,13 +223,25 @@ function VaultixProvider({
     });
     if (afterSignInUrl) window.location.href = afterSignInUrl;
   }, [apiOrigin, afterSignInUrl, clearAuth]);
+  const connectPlatform = (0, import_react.useCallback)((provider, options = {}) => {
+    const params = new URLSearchParams({ mode: "connect" });
+    params.set("redirect_url", options.redirectUrl ?? (typeof window !== "undefined" ? window.location.href : "/"));
+    params.set("pk", publishableKey);
+    if (options.scopes?.length) params.set("scope", options.scopes.join(" "));
+    if (options.configId) params.set("config_id", options.configId);
+    if (options.extraParams) Object.entries(options.extraParams).forEach(([k, v]) => params.set(k, v));
+    if (typeof window !== "undefined") {
+      window.location.href = `${apiOrigin}/api/v1/auth/oauth/${provider}/connect?${params}`;
+    }
+  }, [apiOrigin, publishableKey]);
   const value = {
     user,
     session,
     organization,
     isLoaded,
     isSignedIn: !!session,
-    signOut
+    signOut,
+    connectPlatform
   };
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(VaultixContext.Provider, { value, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
     "div",
@@ -1566,6 +1580,22 @@ function MiniSpinner() {
     /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("path", { className: "opacity-75", fill: "currentColor", d: "M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z" })
   ] });
 }
+
+// src/index.ts
+var STORAGE_KEY2 = "vaultix_jwt";
+function getStoredToken() {
+  try {
+    return (typeof sessionStorage !== "undefined" ? sessionStorage : null)?.getItem(STORAGE_KEY2) ?? null;
+  } catch {
+    return null;
+  }
+}
+function clearStoredToken() {
+  try {
+    if (typeof sessionStorage !== "undefined") sessionStorage.removeItem(STORAGE_KEY2);
+  } catch {
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   OrganizationSwitcher,
@@ -1577,6 +1607,8 @@ function MiniSpinner() {
   SignedOut,
   UserButton,
   VaultixProvider,
+  clearStoredToken,
+  getStoredToken,
   useAuth,
   useOrganization,
   useSession,

package/dist/index.mjs

@@ -189,13 +189,25 @@ function VaultixProvider({
     });
     if (afterSignInUrl) window.location.href = afterSignInUrl;
   }, [apiOrigin, afterSignInUrl, clearAuth]);
+  const connectPlatform = useCallback((provider, options = {}) => {
+    const params = new URLSearchParams({ mode: "connect" });
+    params.set("redirect_url", options.redirectUrl ?? (typeof window !== "undefined" ? window.location.href : "/"));
+    params.set("pk", publishableKey);
+    if (options.scopes?.length) params.set("scope", options.scopes.join(" "));
+    if (options.configId) params.set("config_id", options.configId);
+    if (options.extraParams) Object.entries(options.extraParams).forEach(([k, v]) => params.set(k, v));
+    if (typeof window !== "undefined") {
+      window.location.href = `${apiOrigin}/api/v1/auth/oauth/${provider}/connect?${params}`;
+    }
+  }, [apiOrigin, publishableKey]);
   const value = {
     user,
     session,
     organization,
     isLoaded,
     isSignedIn: !!session,
-    signOut
+    signOut,
+    connectPlatform
   };
   return /* @__PURE__ */ jsx(VaultixContext.Provider, { value, children: /* @__PURE__ */ jsx(
     "div",
@@ -1534,6 +1546,22 @@ function MiniSpinner() {
     /* @__PURE__ */ jsx6("path", { className: "opacity-75", fill: "currentColor", d: "M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z" })
   ] });
 }
+
+// src/index.ts
+var STORAGE_KEY2 = "vaultix_jwt";
+function getStoredToken() {
+  try {
+    return (typeof sessionStorage !== "undefined" ? sessionStorage : null)?.getItem(STORAGE_KEY2) ?? null;
+  } catch {
+    return null;
+  }
+}
+function clearStoredToken() {
+  try {
+    if (typeof sessionStorage !== "undefined") sessionStorage.removeItem(STORAGE_KEY2);
+  } catch {
+  }
+}
 export {
   OrganizationSwitcher,
   RedirectToSignIn,
@@ -1544,6 +1572,8 @@ export {
   SignedOut,
   UserButton,
   VaultixProvider,
+  clearStoredToken,
+  getStoredToken,
   useAuth,
   useOrganization,
   useSession,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaultix.ai/react",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Vaultix-ID React SDK — drop-in auth components for any React app",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",