@iblai/iblai-js 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 IBL AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,88 @@
+# @iblai/iblai-js
+
+Unified package for IBL AI - includes all exports from data-layer, web-utils, and web-containers.
+
+## Installation
+
+```bash
+npm install @iblai/iblai-js
+# or
+yarn add @iblai/iblai-js
+# or
+pnpm add @iblai/iblai-js
+```
+
+## Usage
+
+This package re-exports everything from:
+- `@iblai/data-layer` - API slices, hooks, and data management
+- `@iblai/web-utils` - Utilities, providers, and helper functions
+- `@iblai/web-containers` - UI components and containers
+
+### Example
+
+```typescript
+// Import everything from a single package
+import {
+  // From data-layer
+  useGetMfeContextQuery,
+  authApiSlice,
+
+  // From web-utils
+  AuthProvider,
+  TenantProvider,
+
+  // From web-containers
+  Button,
+  Card,
+  Input
+} from '@iblai/iblai-js';
+
+// Use as normal
+function MyComponent() {
+  const { data } = useGetMfeContextQuery();
+
+  return (
+    <AuthProvider {...authProps}>
+      <Button>Click me</Button>
+    </AuthProvider>
+  );
+}
+```
+
+## What's Included
+
+### From @iblai/data-layer
+- RTK Query API slices for all services
+- Redux store configuration
+- Data fetching hooks
+- Types and interfaces
+
+### From @iblai/web-utils
+- Authentication providers
+- Tenant providers
+- Utility functions
+- Constants and helpers
+
+### From @iblai/web-containers
+- UI components (buttons, forms, cards, etc.)
+- Layout components
+- Custom hooks
+- Styled components
+
+## Peer Dependencies
+
+This package requires the following peer dependencies:
+- `react` ^19.1.0
+- `react-dom` ^19.1.0
+- `@reduxjs/toolkit` ^2.7.0
+- `react-redux` ^9.2.0
+- `@iblai/iblai-api` 4.64.2-ai
+
+## License
+
+ISC
+
+## Author
+
+iblai

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from '@iblai/data-layer';
+export * from '@iblai/web-utils';
+export * from '@iblai/web-containers';

package/dist/index.esm.js

@@ -0,0 +1,4 @@
+export * from '@iblai/data-layer';
+export * from '@iblai/web-utils';
+export * from '@iblai/web-containers';
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/index.js

@@ -0,0 +1,27 @@
+'use strict';
+
+var dataLayer = require('@iblai/data-layer');
+var webUtils = require('@iblai/web-utils');
+var webContainers = require('@iblai/web-containers');
+
+
+
+Object.keys(dataLayer).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return dataLayer[k]; }
+	});
+});
+Object.keys(webUtils).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return webUtils[k]; }
+	});
+});
+Object.keys(webContainers).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return webContainers[k]; }
+	});
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/next/index.d.ts

@@ -0,0 +1 @@
+export * from '@iblai/web-containers/next';

package/dist/next/index.esm.js

@@ -0,0 +1,2 @@
+export * from '@iblai/web-containers/next';
+//# sourceMappingURL=index.esm.js.map

package/dist/next/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/next/index.js

@@ -0,0 +1,13 @@
+'use strict';
+
+var next = require('@iblai/web-containers/next');
+
+
+
+Object.keys(next).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return next[k]; }
+	});
+});
+//# sourceMappingURL=index.js.map

package/dist/next/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;"}

package/dist/next/src/data-layer/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Data Layer - RTK Query API slices and data management
+ *
+ * This module contains all API slices, hooks, and data management utilities
+ * for interacting with the IBL AI Platform.
+ *
+ * @module data-layer
+ */
+export * from '@iblai/data-layer';

package/dist/next/src/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @iblai/iblai-js - TypeScript SDK for IBL AI Platform
+ *
+ * A unified SDK providing:
+ * - Data Layer: RTK Query API slices and data management
+ * - Web Utils: React providers, hooks, and utilities
+ * - Web Containers: React UI components for web
+ * - Native Components: React Native components for mobile
+ *
+ * @example
+ * ```typescript
+ * import { useGetMentorsQuery, AuthProvider, Button } from '@iblai/iblai-js';
+ * ```
+ */
+export * from './data-layer';
+export * from './web-utils';
+export * from './web-containers';

package/dist/next/src/native-components/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Native Components - React Native UI components
+ *
+ * This module contains all reusable React Native components
+ * for building IBL AI mobile applications.
+ *
+ * @module native-components
+ */
+export {};

package/dist/next/src/next/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Next.js-specific components and hooks
+ *
+ * This module contains React components and hooks that require Next.js
+ * as a peer dependency. These components use Next.js-specific APIs like
+ * `next/navigation`, `next/router`, `next/image`, and `next/link`.
+ *
+ * For non-Next.js React applications, you'll need to implement
+ * framework-agnostic alternatives. See the SDK documentation for examples.
+ *
+ * @module next
+ *
+ * @example
+ * ```tsx
+ * // In a Next.js application
+ * import { SsoLogin, ErrorPage, UserProfileDropdown } from '@iblai/iblai-js/next';
+ *
+ * // Use the components as normal
+ * <SsoLogin
+ *   localStorageKeys={{...}}
+ *   redirectPathKey="redirect-to"
+ *   defaultRedirectPath="/"
+ * />
+ * ```
+ */
+export * from '@iblai/web-containers/next';

package/dist/next/src/sso/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * SSO Utilities - Framework agnostic
+ *
+ * This module contains utilities for handling SSO authentication callbacks.
+ * These utilities work in any React application (Next.js, Create React App,
+ * Vite, React Router, etc.) without requiring Next.js.
+ *
+ * For Next.js applications that want to use the pre-built `SsoLogin` component,
+ * import from `@iblai/iblai-js/next` instead.
+ *
+ * @module sso
+ *
+ * @example
+ * ```tsx
+ * // React Router implementation
+ * import { useEffect } from 'react';
+ * import { useNavigate, useSearchParams } from 'react-router-dom';
+ * import { handleSsoCallback } from '@iblai/iblai-js/sso';
+ *
+ * export function SsoLoginPage() {
+ *   const navigate = useNavigate();
+ *   const [searchParams] = useSearchParams();
+ *
+ *   useEffect(() => {
+ *     handleSsoCallback({
+ *       queryParamData: searchParams.get('data'),
+ *       redirectPathKey: 'redirect-to',
+ *       defaultRedirectPath: '/',
+ *       onRedirect: (path) => navigate(path),
+ *       onLoginSuccess: (data) => console.log('Login successful', data),
+ *       onLoginError: (error) => console.error('Login failed', error),
+ *     });
+ *   }, [searchParams, navigate]);
+ *
+ *   return null; // Redirect-only page
+ * }
+ * ```
+ */
+export * from '@iblai/web-containers/sso';

package/dist/next/src/web-containers/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Web Containers - React UI components and containers
+ *
+ * This module contains all reusable React components and containers
+ * for building IBL AI web applications.
+ *
+ * @module web-containers
+ */
+export * from '@iblai/web-containers';

package/dist/next/src/web-utils/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Web Utils - Utilities, providers, hooks, and helper functions
+ *
+ * This module contains React providers, custom hooks, utility functions,
+ * and helper methods for building IBL AI applications.
+ *
+ * @module web-utils
+ */
+export * from '@iblai/web-utils';

package/dist/next/src/web-utils/utils/auth.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Authentication and Authorization Utilities
+ *
+ * This module provides utility functions for handling authentication flows,
+ * including redirects to auth SPA, cookie management, and session handling.
+ */
+/**
+ * Check if the current window is inside an iframe
+ * @returns {boolean} True if running in an iframe, false otherwise
+ */
+export declare function isInIframe(): boolean;
+/**
+ * Send a message to the parent website (when in iframe)
+ * @param payload - The data to send to parent window
+ */
+export declare function sendMessageToParentWebsite(payload: unknown): void;
+/**
+ * Delete a cookie with specific name, path, and domain
+ * @param name - Cookie name
+ * @param path - Cookie path
+ * @param domain - Cookie domain
+ */
+export declare function deleteCookie(name: string, path: string, domain: string): void;
+/**
+ * Get all possible domain parts for cookie deletion
+ * @param domain - The domain to split
+ * @returns Array of domain parts
+ * @example
+ * getDomainParts('app.example.com') // returns ['app.example.com', 'example.com', 'com']
+ */
+export declare function getDomainParts(domain: string): string[];
+/**
+ * Delete a cookie across all possible domain variations
+ * @param name - Cookie name to delete
+ * @param childDomain - The current domain
+ */
+export declare function deleteCookieOnAllDomains(name: string, childDomain: string): void;
+/**
+ * Get the parent domain from a given domain
+ * @param domain - The domain to process
+ * @returns The parent domain (e.g., 'app.example.com' → '.example.com')
+ */
+export declare function getParentDomain(domain?: string): string;
+/**
+ * Set a cookie for authentication with cross-domain support
+ * @param name - Cookie name
+ * @param value - Cookie value
+ * @param days - Number of days until expiration (default: 365)
+ */
+export declare function setCookieForAuth(name: string, value: string, days?: number): void;
+/**
+ * Clear all cookies for the current domain
+ */
+export declare function clearCookies(): void;
+/**
+ * Check if user is currently logged in
+ * @param tokenKey - The localStorage key for the auth token (default: 'axd_token')
+ * @returns True if logged in, false otherwise
+ */
+export declare function isLoggedIn(tokenKey?: string): boolean;
+/**
+ * Extract platform/tenant key from URL
+ * @param url - The URL to parse
+ * @param pattern - RegExp pattern to match platform key (default matches /platform/[key]/...)
+ * @returns The platform key or null if not found
+ */
+export declare function getPlatformKey(url: string, pattern?: RegExp): string | null;
+export interface RedirectToAuthSpaOptions {
+    /** URL to redirect to after auth (defaults to current path + search) */
+    redirectTo?: string;
+    /** Platform/tenant key */
+    platformKey?: string;
+    /** Whether this is a logout action */
+    logout?: boolean;
+    /** Whether to save redirect path to localStorage (default: true) */
+    saveRedirect?: boolean;
+    /** Auth SPA base URL */
+    authUrl: string;
+    /** Current app/platform identifier (e.g., 'mentor', 'skills') */
+    appName: string;
+    /** Query param names */
+    queryParams?: {
+        app?: string;
+        redirectTo?: string;
+        tenant?: string;
+    };
+    /** localStorage key for saving redirect path */
+    redirectPathStorageKey?: string;
+    /** Cookie names for cross-SPA sync */
+    cookieNames?: {
+        currentTenant?: string;
+        userData?: string;
+        tenant?: string;
+        logoutTimestamp?: string;
+    };
+}
+/**
+ * Redirect to authentication SPA for login/logout
+ *
+ * This function handles the complete authentication flow:
+ * - Clears localStorage and cookies on logout
+ * - Saves redirect path for post-auth return
+ * - Handles iframe scenarios
+ * - Syncs logout across multiple SPAs via cookies
+ *
+ * @param options - Configuration options for the redirect
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * redirectToAuthSpa({
+ *   authUrl: 'https://auth.example.com',
+ *   appName: 'mentor',
+ * });
+ *
+ * // With logout
+ * redirectToAuthSpa({
+ *   authUrl: 'https://auth.example.com',
+ *   appName: 'mentor',
+ *   logout: true,
+ *   platformKey: 'my-tenant',
+ * });
+ *
+ * // With custom redirect
+ * redirectToAuthSpa({
+ *   authUrl: 'https://auth.example.com',
+ *   appName: 'mentor',
+ *   redirectTo: '/dashboard',
+ *   platformKey: 'my-tenant',
+ * });
+ * ```
+ */
+export declare function redirectToAuthSpa(options: RedirectToAuthSpaOptions): Promise<void>;
+/**
+ * Get the URL for joining a tenant (sign up flow)
+ * @param authUrl - Auth SPA base URL
+ * @param tenantKey - Tenant to join
+ * @param redirectUrl - URL to redirect to after joining (defaults to current URL)
+ * @returns The join URL
+ */
+export declare function getAuthSpaJoinUrl(authUrl: string, tenantKey?: string, redirectUrl?: string): string;
+/**
+ * Redirect to auth SPA's join/signup page for a specific tenant
+ * @param authUrl - Auth SPA base URL
+ * @param tenantKey - Tenant to join
+ * @param redirectUrl - URL to redirect to after joining (defaults to current URL)
+ */
+export declare function redirectToAuthSpaJoinTenant(authUrl: string, tenantKey?: string, redirectUrl?: string): void;
+export interface HandleLogoutOptions {
+    /** URL to redirect to after logout (defaults to current origin) */
+    redirectUrl?: string;
+    /** Auth SPA base URL */
+    authUrl: string;
+    /** localStorage key for tenant */
+    tenantStorageKey?: string;
+    /** Cookie name for logout timestamp */
+    logoutTimestampCookie?: string;
+    /** Callback to execute before logout */
+    callback?: () => void;
+}
+/**
+ * Handle user logout
+ *
+ * This function:
+ * - Clears localStorage (preserving tenant)
+ * - Sets logout timestamp cookie for cross-SPA sync
+ * - Clears all cookies
+ * - Redirects to auth SPA logout endpoint
+ *
+ * @param options - Logout configuration options
+ *
+ * @example
+ * ```tsx
+ * handleLogout({
+ *   authUrl: 'https://auth.example.com',
+ *   redirectUrl: 'https://app.example.com',
+ * });
+ * ```
+ */
+export declare function handleLogout(options: HandleLogoutOptions): void;

package/dist/src/data-layer/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Data Layer - RTK Query API slices and data management
+ *
+ * This module contains all API slices, hooks, and data management utilities
+ * for interacting with the IBL AI Platform.
+ *
+ * @module data-layer
+ */
+export * from '@iblai/data-layer';

package/dist/src/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @iblai/iblai-js - TypeScript SDK for IBL AI Platform
+ *
+ * A unified SDK providing:
+ * - Data Layer: RTK Query API slices and data management
+ * - Web Utils: React providers, hooks, and utilities
+ * - Web Containers: React UI components for web
+ * - Native Components: React Native components for mobile
+ *
+ * @example
+ * ```typescript
+ * import { useGetMentorsQuery, AuthProvider, Button } from '@iblai/iblai-js';
+ * ```
+ */
+export * from './data-layer';
+export * from './web-utils';
+export * from './web-containers';

package/dist/src/native-components/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Native Components - React Native UI components
+ *
+ * This module contains all reusable React Native components
+ * for building IBL AI mobile applications.
+ *
+ * @module native-components
+ */
+export {};

package/dist/src/next/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Next.js-specific components and hooks
+ *
+ * This module contains React components and hooks that require Next.js
+ * as a peer dependency. These components use Next.js-specific APIs like
+ * `next/navigation`, `next/router`, `next/image`, and `next/link`.
+ *
+ * For non-Next.js React applications, you'll need to implement
+ * framework-agnostic alternatives. See the SDK documentation for examples.
+ *
+ * @module next
+ *
+ * @example
+ * ```tsx
+ * // In a Next.js application
+ * import { SsoLogin, ErrorPage, UserProfileDropdown } from '@iblai/iblai-js/next';
+ *
+ * // Use the components as normal
+ * <SsoLogin
+ *   localStorageKeys={{...}}
+ *   redirectPathKey="redirect-to"
+ *   defaultRedirectPath="/"
+ * />
+ * ```
+ */
+export * from '@iblai/web-containers/next';

package/dist/src/sso/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * SSO Utilities - Framework agnostic
+ *
+ * This module contains utilities for handling SSO authentication callbacks.
+ * These utilities work in any React application (Next.js, Create React App,
+ * Vite, React Router, etc.) without requiring Next.js.
+ *
+ * For Next.js applications that want to use the pre-built `SsoLogin` component,
+ * import from `@iblai/iblai-js/next` instead.
+ *
+ * @module sso
+ *
+ * @example
+ * ```tsx
+ * // React Router implementation
+ * import { useEffect } from 'react';
+ * import { useNavigate, useSearchParams } from 'react-router-dom';
+ * import { handleSsoCallback } from '@iblai/iblai-js/sso';
+ *
+ * export function SsoLoginPage() {
+ *   const navigate = useNavigate();
+ *   const [searchParams] = useSearchParams();
+ *
+ *   useEffect(() => {
+ *     handleSsoCallback({
+ *       queryParamData: searchParams.get('data'),
+ *       redirectPathKey: 'redirect-to',
+ *       defaultRedirectPath: '/',
+ *       onRedirect: (path) => navigate(path),
+ *       onLoginSuccess: (data) => console.log('Login successful', data),
+ *       onLoginError: (error) => console.error('Login failed', error),
+ *     });
+ *   }, [searchParams, navigate]);
+ *
+ *   return null; // Redirect-only page
+ * }
+ * ```
+ */
+export * from '@iblai/web-containers/sso';

package/dist/src/web-containers/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Web Containers - React UI components and containers
+ *
+ * This module contains all reusable React components and containers
+ * for building IBL AI web applications.
+ *
+ * @module web-containers
+ */
+export * from '@iblai/web-containers';

package/dist/src/web-utils/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Web Utils - Utilities, providers, hooks, and helper functions
+ *
+ * This module contains React providers, custom hooks, utility functions,
+ * and helper methods for building IBL AI applications.
+ *
+ * @module web-utils
+ */
+export * from '@iblai/web-utils';

package/dist/src/web-utils/utils/auth.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Authentication and Authorization Utilities
+ *
+ * This module provides utility functions for handling authentication flows,
+ * including redirects to auth SPA, cookie management, and session handling.
+ */
+/**
+ * Check if the current window is inside an iframe
+ * @returns {boolean} True if running in an iframe, false otherwise
+ */
+export declare function isInIframe(): boolean;
+/**
+ * Send a message to the parent website (when in iframe)
+ * @param payload - The data to send to parent window
+ */
+export declare function sendMessageToParentWebsite(payload: unknown): void;
+/**
+ * Delete a cookie with specific name, path, and domain
+ * @param name - Cookie name
+ * @param path - Cookie path
+ * @param domain - Cookie domain
+ */
+export declare function deleteCookie(name: string, path: string, domain: string): void;
+/**
+ * Get all possible domain parts for cookie deletion
+ * @param domain - The domain to split
+ * @returns Array of domain parts
+ * @example
+ * getDomainParts('app.example.com') // returns ['app.example.com', 'example.com', 'com']
+ */
+export declare function getDomainParts(domain: string): string[];
+/**
+ * Delete a cookie across all possible domain variations
+ * @param name - Cookie name to delete
+ * @param childDomain - The current domain
+ */
+export declare function deleteCookieOnAllDomains(name: string, childDomain: string): void;
+/**
+ * Get the parent domain from a given domain
+ * @param domain - The domain to process
+ * @returns The parent domain (e.g., 'app.example.com' → '.example.com')
+ */
+export declare function getParentDomain(domain?: string): string;
+/**
+ * Set a cookie for authentication with cross-domain support
+ * @param name - Cookie name
+ * @param value - Cookie value
+ * @param days - Number of days until expiration (default: 365)
+ */
+export declare function setCookieForAuth(name: string, value: string, days?: number): void;
+/**
+ * Clear all cookies for the current domain
+ */
+export declare function clearCookies(): void;
+/**
+ * Check if user is currently logged in
+ * @param tokenKey - The localStorage key for the auth token (default: 'axd_token')
+ * @returns True if logged in, false otherwise
+ */
+export declare function isLoggedIn(tokenKey?: string): boolean;
+/**
+ * Extract platform/tenant key from URL
+ * @param url - The URL to parse
+ * @param pattern - RegExp pattern to match platform key (default matches /platform/[key]/...)
+ * @returns The platform key or null if not found
+ */
+export declare function getPlatformKey(url: string, pattern?: RegExp): string | null;
+export interface RedirectToAuthSpaOptions {
+    /** URL to redirect to after auth (defaults to current path + search) */
+    redirectTo?: string;
+    /** Platform/tenant key */
+    platformKey?: string;
+    /** Whether this is a logout action */
+    logout?: boolean;
+    /** Whether to save redirect path to localStorage (default: true) */
+    saveRedirect?: boolean;
+    /** Auth SPA base URL */
+    authUrl: string;
+    /** Current app/platform identifier (e.g., 'mentor', 'skills') */
+    appName: string;
+    /** Query param names */
+    queryParams?: {
+        app?: string;
+        redirectTo?: string;
+        tenant?: string;
+    };
+    /** localStorage key for saving redirect path */
+    redirectPathStorageKey?: string;
+    /** Cookie names for cross-SPA sync */
+    cookieNames?: {
+        currentTenant?: string;
+        userData?: string;
+        tenant?: string;
+        logoutTimestamp?: string;
+    };
+}
+/**
+ * Redirect to authentication SPA for login/logout
+ *
+ * This function handles the complete authentication flow:
+ * - Clears localStorage and cookies on logout
+ * - Saves redirect path for post-auth return
+ * - Handles iframe scenarios
+ * - Syncs logout across multiple SPAs via cookies
+ *
+ * @param options - Configuration options for the redirect
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * redirectToAuthSpa({
+ *   authUrl: 'https://auth.example.com',
+ *   appName: 'mentor',
+ * });
+ *
+ * // With logout
+ * redirectToAuthSpa({
+ *   authUrl: 'https://auth.example.com',
+ *   appName: 'mentor',
+ *   logout: true,
+ *   platformKey: 'my-tenant',
+ * });
+ *
+ * // With custom redirect
+ * redirectToAuthSpa({
+ *   authUrl: 'https://auth.example.com',
+ *   appName: 'mentor',
+ *   redirectTo: '/dashboard',
+ *   platformKey: 'my-tenant',
+ * });
+ * ```
+ */
+export declare function redirectToAuthSpa(options: RedirectToAuthSpaOptions): Promise<void>;
+/**
+ * Get the URL for joining a tenant (sign up flow)
+ * @param authUrl - Auth SPA base URL
+ * @param tenantKey - Tenant to join
+ * @param redirectUrl - URL to redirect to after joining (defaults to current URL)
+ * @returns The join URL
+ */
+export declare function getAuthSpaJoinUrl(authUrl: string, tenantKey?: string, redirectUrl?: string): string;
+/**
+ * Redirect to auth SPA's join/signup page for a specific tenant
+ * @param authUrl - Auth SPA base URL
+ * @param tenantKey - Tenant to join
+ * @param redirectUrl - URL to redirect to after joining (defaults to current URL)
+ */
+export declare function redirectToAuthSpaJoinTenant(authUrl: string, tenantKey?: string, redirectUrl?: string): void;
+export interface HandleLogoutOptions {
+    /** URL to redirect to after logout (defaults to current origin) */
+    redirectUrl?: string;
+    /** Auth SPA base URL */
+    authUrl: string;
+    /** localStorage key for tenant */
+    tenantStorageKey?: string;
+    /** Cookie name for logout timestamp */
+    logoutTimestampCookie?: string;
+    /** Callback to execute before logout */
+    callback?: () => void;
+}
+/**
+ * Handle user logout
+ *
+ * This function:
+ * - Clears localStorage (preserving tenant)
+ * - Sets logout timestamp cookie for cross-SPA sync
+ * - Clears all cookies
+ * - Redirects to auth SPA logout endpoint
+ *
+ * @param options - Logout configuration options
+ *
+ * @example
+ * ```tsx
+ * handleLogout({
+ *   authUrl: 'https://auth.example.com',
+ *   redirectUrl: 'https://app.example.com',
+ * });
+ * ```
+ */
+export declare function handleLogout(options: HandleLogoutOptions): void;

package/dist/sso/index.d.ts

@@ -0,0 +1 @@
+export * from '@iblai/web-containers/sso';

package/dist/sso/index.esm.js

@@ -0,0 +1,2 @@
+export * from '@iblai/web-containers/sso';
+//# sourceMappingURL=index.esm.js.map

package/dist/sso/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/sso/index.js

@@ -0,0 +1,13 @@
+'use strict';
+
+var sso = require('@iblai/web-containers/sso');
+
+
+
+Object.keys(sso).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return sso[k]; }
+	});
+});
+//# sourceMappingURL=index.js.map

package/dist/sso/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;"}

package/dist/sso/src/data-layer/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Data Layer - RTK Query API slices and data management
+ *
+ * This module contains all API slices, hooks, and data management utilities
+ * for interacting with the IBL AI Platform.
+ *
+ * @module data-layer
+ */
+export * from '@iblai/data-layer';

package/dist/sso/src/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @iblai/iblai-js - TypeScript SDK for IBL AI Platform
+ *
+ * A unified SDK providing:
+ * - Data Layer: RTK Query API slices and data management
+ * - Web Utils: React providers, hooks, and utilities
+ * - Web Containers: React UI components for web
+ * - Native Components: React Native components for mobile
+ *
+ * @example
+ * ```typescript
+ * import { useGetMentorsQuery, AuthProvider, Button } from '@iblai/iblai-js';
+ * ```
+ */
+export * from './data-layer';
+export * from './web-utils';
+export * from './web-containers';

package/dist/sso/src/native-components/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Native Components - React Native UI components
+ *
+ * This module contains all reusable React Native components
+ * for building IBL AI mobile applications.
+ *
+ * @module native-components
+ */
+export {};

package/dist/sso/src/next/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Next.js-specific components and hooks
+ *
+ * This module contains React components and hooks that require Next.js
+ * as a peer dependency. These components use Next.js-specific APIs like
+ * `next/navigation`, `next/router`, `next/image`, and `next/link`.
+ *
+ * For non-Next.js React applications, you'll need to implement
+ * framework-agnostic alternatives. See the SDK documentation for examples.
+ *
+ * @module next
+ *
+ * @example
+ * ```tsx
+ * // In a Next.js application
+ * import { SsoLogin, ErrorPage, UserProfileDropdown } from '@iblai/iblai-js/next';
+ *
+ * // Use the components as normal
+ * <SsoLogin
+ *   localStorageKeys={{...}}
+ *   redirectPathKey="redirect-to"
+ *   defaultRedirectPath="/"
+ * />
+ * ```
+ */
+export * from '@iblai/web-containers/next';

package/dist/sso/src/sso/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * SSO Utilities - Framework agnostic
+ *
+ * This module contains utilities for handling SSO authentication callbacks.
+ * These utilities work in any React application (Next.js, Create React App,
+ * Vite, React Router, etc.) without requiring Next.js.
+ *
+ * For Next.js applications that want to use the pre-built `SsoLogin` component,
+ * import from `@iblai/iblai-js/next` instead.
+ *
+ * @module sso
+ *
+ * @example
+ * ```tsx
+ * // React Router implementation
+ * import { useEffect } from 'react';
+ * import { useNavigate, useSearchParams } from 'react-router-dom';
+ * import { handleSsoCallback } from '@iblai/iblai-js/sso';
+ *
+ * export function SsoLoginPage() {
+ *   const navigate = useNavigate();
+ *   const [searchParams] = useSearchParams();
+ *
+ *   useEffect(() => {
+ *     handleSsoCallback({
+ *       queryParamData: searchParams.get('data'),
+ *       redirectPathKey: 'redirect-to',
+ *       defaultRedirectPath: '/',
+ *       onRedirect: (path) => navigate(path),
+ *       onLoginSuccess: (data) => console.log('Login successful', data),
+ *       onLoginError: (error) => console.error('Login failed', error),
+ *     });
+ *   }, [searchParams, navigate]);
+ *
+ *   return null; // Redirect-only page
+ * }
+ * ```
+ */
+export * from '@iblai/web-containers/sso';

package/dist/sso/src/web-containers/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Web Containers - React UI components and containers
+ *
+ * This module contains all reusable React components and containers
+ * for building IBL AI web applications.
+ *
+ * @module web-containers
+ */
+export * from '@iblai/web-containers';

package/dist/sso/src/web-utils/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Web Utils - Utilities, providers, hooks, and helper functions
+ *
+ * This module contains React providers, custom hooks, utility functions,
+ * and helper methods for building IBL AI applications.
+ *
+ * @module web-utils
+ */
+export * from '@iblai/web-utils';

package/dist/sso/src/web-utils/utils/auth.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Authentication and Authorization Utilities
+ *
+ * This module provides utility functions for handling authentication flows,
+ * including redirects to auth SPA, cookie management, and session handling.
+ */
+/**
+ * Check if the current window is inside an iframe
+ * @returns {boolean} True if running in an iframe, false otherwise
+ */
+export declare function isInIframe(): boolean;
+/**
+ * Send a message to the parent website (when in iframe)
+ * @param payload - The data to send to parent window
+ */
+export declare function sendMessageToParentWebsite(payload: unknown): void;
+/**
+ * Delete a cookie with specific name, path, and domain
+ * @param name - Cookie name
+ * @param path - Cookie path
+ * @param domain - Cookie domain
+ */
+export declare function deleteCookie(name: string, path: string, domain: string): void;
+/**
+ * Get all possible domain parts for cookie deletion
+ * @param domain - The domain to split
+ * @returns Array of domain parts
+ * @example
+ * getDomainParts('app.example.com') // returns ['app.example.com', 'example.com', 'com']
+ */
+export declare function getDomainParts(domain: string): string[];
+/**
+ * Delete a cookie across all possible domain variations
+ * @param name - Cookie name to delete
+ * @param childDomain - The current domain
+ */
+export declare function deleteCookieOnAllDomains(name: string, childDomain: string): void;
+/**
+ * Get the parent domain from a given domain
+ * @param domain - The domain to process
+ * @returns The parent domain (e.g., 'app.example.com' → '.example.com')
+ */
+export declare function getParentDomain(domain?: string): string;
+/**
+ * Set a cookie for authentication with cross-domain support
+ * @param name - Cookie name
+ * @param value - Cookie value
+ * @param days - Number of days until expiration (default: 365)
+ */
+export declare function setCookieForAuth(name: string, value: string, days?: number): void;
+/**
+ * Clear all cookies for the current domain
+ */
+export declare function clearCookies(): void;
+/**
+ * Check if user is currently logged in
+ * @param tokenKey - The localStorage key for the auth token (default: 'axd_token')
+ * @returns True if logged in, false otherwise
+ */
+export declare function isLoggedIn(tokenKey?: string): boolean;
+/**
+ * Extract platform/tenant key from URL
+ * @param url - The URL to parse
+ * @param pattern - RegExp pattern to match platform key (default matches /platform/[key]/...)
+ * @returns The platform key or null if not found
+ */
+export declare function getPlatformKey(url: string, pattern?: RegExp): string | null;
+export interface RedirectToAuthSpaOptions {
+    /** URL to redirect to after auth (defaults to current path + search) */
+    redirectTo?: string;
+    /** Platform/tenant key */
+    platformKey?: string;
+    /** Whether this is a logout action */
+    logout?: boolean;
+    /** Whether to save redirect path to localStorage (default: true) */
+    saveRedirect?: boolean;
+    /** Auth SPA base URL */
+    authUrl: string;
+    /** Current app/platform identifier (e.g., 'mentor', 'skills') */
+    appName: string;
+    /** Query param names */
+    queryParams?: {
+        app?: string;
+        redirectTo?: string;
+        tenant?: string;
+    };
+    /** localStorage key for saving redirect path */
+    redirectPathStorageKey?: string;
+    /** Cookie names for cross-SPA sync */
+    cookieNames?: {
+        currentTenant?: string;
+        userData?: string;
+        tenant?: string;
+        logoutTimestamp?: string;
+    };
+}
+/**
+ * Redirect to authentication SPA for login/logout
+ *
+ * This function handles the complete authentication flow:
+ * - Clears localStorage and cookies on logout
+ * - Saves redirect path for post-auth return
+ * - Handles iframe scenarios
+ * - Syncs logout across multiple SPAs via cookies
+ *
+ * @param options - Configuration options for the redirect
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * redirectToAuthSpa({
+ *   authUrl: 'https://auth.example.com',
+ *   appName: 'mentor',
+ * });
+ *
+ * // With logout
+ * redirectToAuthSpa({
+ *   authUrl: 'https://auth.example.com',
+ *   appName: 'mentor',
+ *   logout: true,
+ *   platformKey: 'my-tenant',
+ * });
+ *
+ * // With custom redirect
+ * redirectToAuthSpa({
+ *   authUrl: 'https://auth.example.com',
+ *   appName: 'mentor',
+ *   redirectTo: '/dashboard',
+ *   platformKey: 'my-tenant',
+ * });
+ * ```
+ */
+export declare function redirectToAuthSpa(options: RedirectToAuthSpaOptions): Promise<void>;
+/**
+ * Get the URL for joining a tenant (sign up flow)
+ * @param authUrl - Auth SPA base URL
+ * @param tenantKey - Tenant to join
+ * @param redirectUrl - URL to redirect to after joining (defaults to current URL)
+ * @returns The join URL
+ */
+export declare function getAuthSpaJoinUrl(authUrl: string, tenantKey?: string, redirectUrl?: string): string;
+/**
+ * Redirect to auth SPA's join/signup page for a specific tenant
+ * @param authUrl - Auth SPA base URL
+ * @param tenantKey - Tenant to join
+ * @param redirectUrl - URL to redirect to after joining (defaults to current URL)
+ */
+export declare function redirectToAuthSpaJoinTenant(authUrl: string, tenantKey?: string, redirectUrl?: string): void;
+export interface HandleLogoutOptions {
+    /** URL to redirect to after logout (defaults to current origin) */
+    redirectUrl?: string;
+    /** Auth SPA base URL */
+    authUrl: string;
+    /** localStorage key for tenant */
+    tenantStorageKey?: string;
+    /** Cookie name for logout timestamp */
+    logoutTimestampCookie?: string;
+    /** Callback to execute before logout */
+    callback?: () => void;
+}
+/**
+ * Handle user logout
+ *
+ * This function:
+ * - Clears localStorage (preserving tenant)
+ * - Sets logout timestamp cookie for cross-SPA sync
+ * - Clears all cookies
+ * - Redirects to auth SPA logout endpoint
+ *
+ * @param options - Logout configuration options
+ *
+ * @example
+ * ```tsx
+ * handleLogout({
+ *   authUrl: 'https://auth.example.com',
+ *   redirectUrl: 'https://app.example.com',
+ * });
+ * ```
+ */
+export declare function handleLogout(options: HandleLogoutOptions): void;

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@iblai/iblai-js",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for IBL AI Platform - Unified package for data layer, utilities, and React components",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "module": "dist/index.esm.js",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.js"
+    },
+    "./next": {
+      "types": "./dist/next/index.d.ts",
+      "import": "./dist/next/index.esm.js",
+      "require": "./dist/next/index.js"
+    },
+    "./sso": {
+      "types": "./dist/sso/index.d.ts",
+      "import": "./dist/sso/index.esm.js",
+      "require": "./dist/sso/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "iblai",
+    "sdk",
+    "typescript",
+    "react",
+    "data-layer",
+    "web-utils",
+    "components",
+    "rtk-query",
+    "education",
+    "ai",
+    "mentor"
+  ],
+  "author": "IBL AI <dev@ibl.ai>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/iblai/iblai-sdk.git",
+    "directory": "packages/iblai-js"
+  },
+  "bugs": {
+    "url": "https://github.com/iblai/iblai-sdk/issues"
+  },
+  "homepage": "https://github.com/iblai/iblai-sdk#readme",
+  "dependencies": {
+    "@iblai/data-layer": "^1.1.2",
+    "@iblai/web-utils": "^1.1.2",
+    "@iblai/web-containers": "^1.1.3"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "25.0.8",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "15.3.1",
+    "@rollup/plugin-typescript": "11.1.6",
+    "@types/node": "^22.19.0",
+    "@types/react": "19.1.17",
+    "rollup": "4.40.0",
+    "rollup-plugin-dts": "^6.2.3",
+    "rollup-plugin-peer-deps-external": "2.2.4",
+    "rollup-plugin-typescript2": "0.36.0",
+    "tslib": "2.8.1",
+    "typescript": "5.8.3"
+  },
+  "peerDependencies": {
+    "@reduxjs/toolkit": "^2.0.0",
+    "next": ">=13.0.0",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
+    "react-redux": "^9.0.0",
+    "react-router-dom": "^6.0.0 || ^7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
+    "react-router-dom": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "rollup -c",
+    "watch": "rollup -c -w",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}