@cas-system/react-cas-client 1.0.0 → 1.0.1

package/dist/cas-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cas-client.js","sourceRoot":"","sources":["../src/cas-client.ts"],"names":[],"mappings":"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"}

package/dist/components/CasLoginButton.d.ts

@@ -0,0 +1,40 @@
+import type { ButtonHTMLAttributes, ReactNode } from 'react';
+/**
+ * Props for the {@link CasLoginButton} component.
+ */
+export interface CasLoginButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onClick'> {
+    /**
+     * URL to return to after CAS authentication.
+     * If omitted, the current page URL is used.
+     */
+    returnUrl?: string;
+    /**
+     * Custom CSS class name(s) for the button element.
+     */
+    className?: string;
+    /**
+     * Custom button content. Defaults to `"Sign in"`.
+     */
+    children?: ReactNode;
+}
+/**
+ * Pre-wired button that triggers CAS SSO login on click.
+ *
+ * Accepts all standard `<button>` HTML attributes (except `onClick`, which
+ * is handled internally).
+ *
+ * @example
+ * ```tsx
+ * import { CasLoginButton } from '@cas-system/react-cas-client';
+ *
+ * // Default label
+ * <CasLoginButton className="btn btn-primary" />
+ *
+ * // Custom label and return URL
+ * <CasLoginButton returnUrl="/dashboard">
+ *   🔑 Log in with SSO
+ * </CasLoginButton>
+ * ```
+ */
+export declare function CasLoginButton({ returnUrl, className, children, ...rest }: CasLoginButtonProps): import("react").JSX.Element;
+//# sourceMappingURL=CasLoginButton.d.ts.map

package/dist/components/CasLoginButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CasLoginButton.d.ts","sourceRoot":"","sources":["../../src/components/CasLoginButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAG7D;;GAEG;AACH,MAAM,WAAW,mBACf,SAAQ,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC;IAChE;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,SAAS,EACT,SAAS,EACT,QAAoB,EACpB,GAAG,IAAI,EACR,EAAE,mBAAmB,+BAarB"}

package/dist/components/CasLoginButton.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCasAuth } from '../hooks/useCasAuth';
+/**
+ * Pre-wired button that triggers CAS SSO login on click.
+ *
+ * Accepts all standard `<button>` HTML attributes (except `onClick`, which
+ * is handled internally).
+ *
+ * @example
+ * ```tsx
+ * import { CasLoginButton } from '@cas-system/react-cas-client';
+ *
+ * // Default label
+ * <CasLoginButton className="btn btn-primary" />
+ *
+ * // Custom label and return URL
+ * <CasLoginButton returnUrl="/dashboard">
+ *   🔑 Log in with SSO
+ * </CasLoginButton>
+ * ```
+ */
+export function CasLoginButton({ returnUrl, className, children = 'Sign in', ...rest }) {
+    const { login } = useCasAuth();
+    return (_jsx("button", { type: "button", className: className, onClick: () => login(returnUrl), ...rest, children: children }));
+}
+//# sourceMappingURL=CasLoginButton.js.map

package/dist/components/CasLoginButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CasLoginButton.js","sourceRoot":"","sources":["../../src/components/CasLoginButton.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAwBjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,SAAS,EACT,SAAS,EACT,QAAQ,GAAG,SAAS,EACpB,GAAG,IAAI,EACa;IACpB,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE,CAAC;IAE/B,OAAO,CACL,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,KAC3B,IAAI,YAEP,QAAQ,GACF,CACV,CAAC;AACJ,CAAC"}

package/dist/components/CasProtectedRoute.d.ts

@@ -0,0 +1,53 @@
+import type { ReactNode } from 'react';
+/**
+ * Props for the {@link CasProtectedRoute} component.
+ */
+export interface CasProtectedRouteProps {
+    /** The content to render when the user is authenticated (and authorised). */
+    children: ReactNode;
+    /**
+     * Component to render while the auth state is loading (e.g. during token
+     * validation). Defaults to `null` (renders nothing).
+     */
+    fallback?: ReactNode;
+    /**
+     * Roles required to access this route. If specified, the user must have
+     * **at least one** of these roles to see the children.
+     */
+    roles?: string[];
+    /**
+     * Component to render when the user is authenticated but lacks the
+     * required roles. If omitted, the user is redirected to the CAS login page.
+     */
+    unauthorizedComponent?: ReactNode;
+}
+/**
+ * Protects a route (or any component subtree) behind CAS authentication.
+ *
+ * - If the user is **not authenticated**, they are automatically redirected
+ *   to the CAS SSO login page.
+ * - If **roles** are specified and the user does not have any of them,
+ *   either `unauthorizedComponent` is rendered or the user is redirected.
+ * - While auth state is loading, `fallback` is rendered (default: nothing).
+ *
+ * @example
+ * ```tsx
+ * import { CasProtectedRoute } from '@cas-system/react-cas-client';
+ *
+ * // Basic protection
+ * <CasProtectedRoute fallback={<Spinner />}>
+ *   <Dashboard />
+ * </CasProtectedRoute>
+ *
+ * // Role-based protection
+ * <CasProtectedRoute
+ *   roles={['admin', 'manager']}
+ *   unauthorizedComponent={<ForbiddenPage />}
+ *   fallback={<Spinner />}
+ * >
+ *   <AdminPanel />
+ * </CasProtectedRoute>
+ * ```
+ */
+export declare function CasProtectedRoute({ children, fallback, roles, unauthorizedComponent, }: CasProtectedRouteProps): import("react").JSX.Element;
+//# sourceMappingURL=CasProtectedRoute.d.ts.map

package/dist/components/CasProtectedRoute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CasProtectedRoute.d.ts","sourceRoot":"","sources":["../../src/components/CasProtectedRoute.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,SAAS,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,QAAe,EACf,KAAK,EACL,qBAAqB,GACtB,EAAE,sBAAsB,+BA0BxB"}

package/dist/components/CasProtectedRoute.js

@@ -0,0 +1,54 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useCasAuth } from '../hooks/useCasAuth';
+/**
+ * Protects a route (or any component subtree) behind CAS authentication.
+ *
+ * - If the user is **not authenticated**, they are automatically redirected
+ *   to the CAS SSO login page.
+ * - If **roles** are specified and the user does not have any of them,
+ *   either `unauthorizedComponent` is rendered or the user is redirected.
+ * - While auth state is loading, `fallback` is rendered (default: nothing).
+ *
+ * @example
+ * ```tsx
+ * import { CasProtectedRoute } from '@cas-system/react-cas-client';
+ *
+ * // Basic protection
+ * <CasProtectedRoute fallback={<Spinner />}>
+ *   <Dashboard />
+ * </CasProtectedRoute>
+ *
+ * // Role-based protection
+ * <CasProtectedRoute
+ *   roles={['admin', 'manager']}
+ *   unauthorizedComponent={<ForbiddenPage />}
+ *   fallback={<Spinner />}
+ * >
+ *   <AdminPanel />
+ * </CasProtectedRoute>
+ * ```
+ */
+export function CasProtectedRoute({ children, fallback = null, roles, unauthorizedComponent, }) {
+    const { isAuthenticated, isLoading, login, hasAnyRole } = useCasAuth();
+    // Still resolving auth state — show fallback
+    if (isLoading) {
+        return _jsx(_Fragment, { children: fallback });
+    }
+    // Not authenticated — redirect to CAS login
+    if (!isAuthenticated) {
+        login();
+        return _jsx(_Fragment, { children: fallback });
+    }
+    // Authenticated but missing required roles
+    if (roles && roles.length > 0 && !hasAnyRole(roles)) {
+        if (unauthorizedComponent) {
+            return _jsx(_Fragment, { children: unauthorizedComponent });
+        }
+        // No custom unauthorized view — redirect to login as a fallback
+        login();
+        return _jsx(_Fragment, { children: fallback });
+    }
+    // Authenticated and authorised
+    return _jsx(_Fragment, { children: children });
+}
+//# sourceMappingURL=CasProtectedRoute.js.map

package/dist/components/CasProtectedRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CasProtectedRoute.js","sourceRoot":"","sources":["../../src/components/CasProtectedRoute.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AA4BjD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAChC,QAAQ,EACR,QAAQ,GAAG,IAAI,EACf,KAAK,EACL,qBAAqB,GACE;IACvB,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAAC;IAEvE,6CAA6C;IAC7C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,4BAAG,QAAQ,GAAI,CAAC;IACzB,CAAC;IAED,4CAA4C;IAC5C,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,KAAK,EAAE,CAAC;QACR,OAAO,4BAAG,QAAQ,GAAI,CAAC;IACzB,CAAC;IAED,2CAA2C;IAC3C,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,IAAI,qBAAqB,EAAE,CAAC;YAC1B,OAAO,4BAAG,qBAAqB,GAAI,CAAC;QACtC,CAAC;QACD,gEAAgE;QAChE,KAAK,EAAE,CAAC;QACR,OAAO,4BAAG,QAAQ,GAAI,CAAC;IACzB,CAAC;IAED,+BAA+B;IAC/B,OAAO,4BAAG,QAAQ,GAAI,CAAC;AACzB,CAAC"}

package/dist/hooks/useCasAuth.d.ts

@@ -0,0 +1,34 @@
+import type { CasContextValue } from '../types';
+/**
+ * Hook that provides the full CAS authentication state and actions.
+ *
+ * Must be used within a `<CasProvider>`.
+ *
+ * @returns The current {@link CasContextValue} containing `user`,
+ *   `isAuthenticated`, `isLoading`, `error`, `login`, `logout`,
+ *   `hasRole`, and `hasAnyRole`.
+ *
+ * @throws {Error} If called outside of a `<CasProvider>`.
+ *
+ * @example
+ * ```tsx
+ * import { useCasAuth } from '@cas-system/react-cas-client';
+ *
+ * function Header() {
+ *   const { user, isAuthenticated, login, logout } = useCasAuth();
+ *
+ *   if (!isAuthenticated) {
+ *     return <button onClick={() => login()}>Sign in</button>;
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       Welcome, {user?.username}
+ *       <button onClick={() => logout()}>Sign out</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useCasAuth(): CasContextValue;
+//# sourceMappingURL=useCasAuth.d.ts.map

package/dist/hooks/useCasAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCasAuth.d.ts","sourceRoot":"","sources":["../../src/hooks/useCasAuth.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,UAAU,IAAI,eAAe,CAW5C"}

package/dist/hooks/useCasAuth.js

@@ -0,0 +1,42 @@
+import { useContext } from 'react';
+import { CasContext } from '../CasProvider';
+/**
+ * Hook that provides the full CAS authentication state and actions.
+ *
+ * Must be used within a `<CasProvider>`.
+ *
+ * @returns The current {@link CasContextValue} containing `user`,
+ *   `isAuthenticated`, `isLoading`, `error`, `login`, `logout`,
+ *   `hasRole`, and `hasAnyRole`.
+ *
+ * @throws {Error} If called outside of a `<CasProvider>`.
+ *
+ * @example
+ * ```tsx
+ * import { useCasAuth } from '@cas-system/react-cas-client';
+ *
+ * function Header() {
+ *   const { user, isAuthenticated, login, logout } = useCasAuth();
+ *
+ *   if (!isAuthenticated) {
+ *     return <button onClick={() => login()}>Sign in</button>;
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       Welcome, {user?.username}
+ *       <button onClick={() => logout()}>Sign out</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useCasAuth() {
+    const context = useContext(CasContext);
+    if (!context) {
+        throw new Error('useCasAuth() must be used within a <CasProvider>. ' +
+            'Wrap your component tree with <CasProvider config={...}>.');
+    }
+    return context;
+}
+//# sourceMappingURL=useCasAuth.js.map

package/dist/hooks/useCasAuth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCasAuth.js","sourceRoot":"","sources":["../../src/hooks/useCasAuth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IAEvC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,oDAAoD;YAClD,2DAA2D,CAC9D,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/hooks/useCasUser.d.ts

@@ -0,0 +1,58 @@
+import type { CasUser } from '../types';
+/**
+ * Return type for the {@link useCasUser} hook.
+ */
+export interface UseCasUserReturn {
+    /** The currently authenticated user, or `null`. */
+    user: CasUser | null;
+    /** Whether a user session exists. */
+    isAuthenticated: boolean;
+    /** Whether the SDK is currently loading (e.g. validating a callback token). */
+    isLoading: boolean;
+    /**
+     * Check if the user has a specific role.
+     * @param role - The role name to check.
+     */
+    hasRole: (role: string) => boolean;
+    /**
+     * Check if the user has at least one of the given roles.
+     * @param roles - The role names to check.
+     */
+    hasAnyRole: (roles: string[]) => boolean;
+    /**
+     * Check if the user has all of the given roles.
+     * @param roles - The role names to check.
+     */
+    hasAllRoles: (roles: string[]) => boolean;
+}
+/**
+ * Hook that returns just the user data and role-checking helpers.
+ *
+ * This is a convenience wrapper around {@link useCasAuth} for components
+ * that only need to read user information without triggering login/logout.
+ *
+ * Must be used within a `<CasProvider>`.
+ *
+ * @returns An object with `user`, `isAuthenticated`, `isLoading`, and
+ *   role-checking functions.
+ *
+ * @example
+ * ```tsx
+ * import { useCasUser } from '@cas-system/react-cas-client';
+ *
+ * function ProfileBadge() {
+ *   const { user, hasRole } = useCasUser();
+ *
+ *   if (!user) return null;
+ *
+ *   return (
+ *     <span>
+ *       {user.username}
+ *       {hasRole('admin') && ' 👑'}
+ *     </span>
+ *   );
+ * }
+ * ```
+ */
+export declare function useCasUser(): UseCasUserReturn;
+//# sourceMappingURL=useCasUser.d.ts.map

package/dist/hooks/useCasUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCasUser.d.ts","sourceRoot":"","sources":["../../src/hooks/useCasUser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAErB,qCAAqC;IACrC,eAAe,EAAE,OAAO,CAAC;IAEzB,+EAA+E;IAC/E,SAAS,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAEnC;;;OAGG;IACH,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;IAEzC;;;OAGG;IACH,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,UAAU,IAAI,gBAAgB,CAsB7C"}

package/dist/hooks/useCasUser.js

@@ -0,0 +1,50 @@
+import { useMemo } from 'react';
+import { useCasAuth } from './useCasAuth';
+/**
+ * Hook that returns just the user data and role-checking helpers.
+ *
+ * This is a convenience wrapper around {@link useCasAuth} for components
+ * that only need to read user information without triggering login/logout.
+ *
+ * Must be used within a `<CasProvider>`.
+ *
+ * @returns An object with `user`, `isAuthenticated`, `isLoading`, and
+ *   role-checking functions.
+ *
+ * @example
+ * ```tsx
+ * import { useCasUser } from '@cas-system/react-cas-client';
+ *
+ * function ProfileBadge() {
+ *   const { user, hasRole } = useCasUser();
+ *
+ *   if (!user) return null;
+ *
+ *   return (
+ *     <span>
+ *       {user.username}
+ *       {hasRole('admin') && ' 👑'}
+ *     </span>
+ *   );
+ * }
+ * ```
+ */
+export function useCasUser() {
+    const { user, isAuthenticated, isLoading, hasRole, hasAnyRole } = useCasAuth();
+    const hasAllRoles = useMemo(() => {
+        return (roles) => {
+            if (!user?.roles)
+                return false;
+            return roles.every((role) => user.roles.includes(role));
+        };
+    }, [user]);
+    return useMemo(() => ({
+        user,
+        isAuthenticated,
+        isLoading,
+        hasRole,
+        hasAnyRole,
+        hasAllRoles,
+    }), [user, isAuthenticated, isLoading, hasRole, hasAnyRole, hasAllRoles]);
+}
+//# sourceMappingURL=useCasUser.js.map

package/dist/hooks/useCasUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCasUser.js","sourceRoot":"","sources":["../../src/hooks/useCasUser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAmC1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,GAC7D,UAAU,EAAE,CAAC;IAEf,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE;QAC/B,OAAO,CAAC,KAAe,EAAW,EAAE;YAClC,IAAI,CAAC,IAAI,EAAE,KAAK;gBAAE,OAAO,KAAK,CAAC;YAC/B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,IAAI;QACJ,eAAe;QACf,SAAS;QACT,OAAO;QACP,UAAU;QACV,WAAW;KACZ,CAAC,EACF,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,CACrE,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @module @cas-system/react-cas-client
+ * @description React SDK for CAS (Central Authentication System) integration.
+ *
+ * Provides hooks, components, and a context provider for seamless SSO
+ * authentication with a CAS server.
+ *
+ * @example
+ * ```tsx
+ * import {
+ *   CasProvider,
+ *   useCasAuth,
+ *   CasProtectedRoute,
+ * } from '@cas-system/react-cas-client';
+ * ```
+ */
+export type { CasConfig, CasUser, CasAuthState, CasAuthActions, CasContextValue, } from './types';
+export { CasClient } from './cas-client';
+export { CasProvider, CasContext } from './CasProvider';
+export type { CasProviderProps } from './CasProvider';
+export { useCasAuth } from './hooks/useCasAuth';
+export { useCasUser } from './hooks/useCasUser';
+export type { UseCasUserReturn } from './hooks/useCasUser';
+export { CasProtectedRoute } from './components/CasProtectedRoute';
+export type { CasProtectedRouteProps } from './components/CasProtectedRoute';
+export { CasLoginButton } from './components/CasLoginButton';
+export type { CasLoginButtonProps } from './components/CasLoginButton';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,YAAY,EACV,SAAS,EACT,OAAO,EACP,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,SAAS,CAAC;AAKjB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAKzC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAKtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAK3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+/**
+ * @module @cas-system/react-cas-client
+ * @description React SDK for CAS (Central Authentication System) integration.
+ *
+ * Provides hooks, components, and a context provider for seamless SSO
+ * authentication with a CAS server.
+ *
+ * @example
+ * ```tsx
+ * import {
+ *   CasProvider,
+ *   useCasAuth,
+ *   CasProtectedRoute,
+ * } from '@cas-system/react-cas-client';
+ * ```
+ */
+// ---------------------------------------------------------------------------
+// Core client
+// ---------------------------------------------------------------------------
+export { CasClient } from './cas-client';
+// ---------------------------------------------------------------------------
+// React Context & Provider
+// ---------------------------------------------------------------------------
+export { CasProvider, CasContext } from './CasProvider';
+// ---------------------------------------------------------------------------
+// Hooks
+// ---------------------------------------------------------------------------
+export { useCasAuth } from './hooks/useCasAuth';
+export { useCasUser } from './hooks/useCasUser';
+// ---------------------------------------------------------------------------
+// Components
+// ---------------------------------------------------------------------------
+export { CasProtectedRoute } from './components/CasProtectedRoute';
+export { CasLoginButton } from './components/CasLoginButton';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAaH,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAC9E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGxD,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGnE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * @module types
+ * @description Core TypeScript interfaces for the CAS Client SDK.
+ */
+/**
+ * Configuration for the CAS client.
+ *
+ * @example
+ * ```ts
+ * const config: CasConfig = {
+ *   serverUrl: 'https://cas.example.com',
+ *   clientId: 'my-app',
+ *   callbackUrl: 'https://myapp.com/auth/callback',
+ *   backendValidateUrl: '/api/auth/validate',
+ * };
+ * ```
+ */
+export interface CasConfig {
+    /**
+     * The base URL of the CAS server (no trailing slash).
+     * @example 'https://cas.example.com'
+     */
+    serverUrl: string;
+    /**
+     * The OAuth client ID registered with the CAS server.
+     */
+    clientId: string;
+    /**
+     * The URL the CAS server should redirect to after authentication.
+     * Defaults to the current page URL (`window.location.href`) if omitted.
+     */
+    callbackUrl?: string;
+    /**
+     * URL of your backend endpoint that proxies token validation to the CAS server.
+     * Tokens are NEVER validated in the browser — they must be sent to your backend,
+     * which calls `POST {serverUrl}/api/validate-token` with the `client_secret`.
+     *
+     * @example '/api/auth/validate'
+     */
+    backendValidateUrl?: string;
+}
+/**
+ * Represents an authenticated CAS user.
+ */
+export interface CasUser {
+    /** Unique user identifier from the CAS server. */
+    id: string;
+    /** The user's login name. */
+    username: string;
+    /** The user's email address. */
+    email: string;
+    /**
+     * Roles assigned to this user (e.g. `['admin', 'editor']`).
+     * May be `undefined` if the CAS server does not return roles.
+     */
+    roles?: string[];
+}
+/**
+ * The authentication state exposed by the CAS context and hooks.
+ */
+export interface CasAuthState {
+    /** The currently authenticated user, or `null` if not authenticated. */
+    user: CasUser | null;
+    /** Whether the user is currently authenticated. */
+    isAuthenticated: boolean;
+    /** Whether the SDK is performing an authentication operation (e.g. validating a callback token). */
+    isLoading: boolean;
+    /** The last authentication error, or `null` if no error occurred. */
+    error: string | null;
+}
+/**
+ * Actions available through the CAS context.
+ */
+export interface CasAuthActions {
+    /**
+     * Redirect the user to the CAS SSO login page.
+     * @param returnUrl - Optional URL to return to after login (defaults to current page).
+     */
+    login: (returnUrl?: string) => void;
+    /**
+     * Log the user out: clears the session, calls the CAS logout endpoint, and optionally redirects.
+     * @param redirectUrl - Optional URL to redirect to after logout.
+     */
+    logout: (redirectUrl?: string) => Promise<void>;
+    /**
+     * Check whether the current user has a specific role.
+     * @param role - The role to check.
+     * @returns `true` if the user has the given role.
+     */
+    hasRole: (role: string) => boolean;
+    /**
+     * Check whether the current user has at least one of the given roles.
+     * @param roles - The roles to check.
+     * @returns `true` if the user has any of the given roles.
+     */
+    hasAnyRole: (roles: string[]) => boolean;
+}
+/**
+ * The full context value provided by {@link CasProvider}.
+ */
+export interface CasContextValue extends CasAuthState, CasAuthActions {
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IAEX,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IAEjB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAErB,mDAAmD;IACnD,eAAe,EAAE,OAAO,CAAC;IAEzB,oGAAoG;IACpG,SAAS,EAAE,OAAO,CAAC;IAEnB,qEAAqE;IACrE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpC;;;OAGG;IACH,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;OAIG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAEnC;;;;OAIG;IACH,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,YAAY,EAAE,cAAc;CAAG"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * @module types
+ * @description Core TypeScript interfaces for the CAS Client SDK.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@cas-system/react-cas-client",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "React SDK for CAS (Central Authentication System) integration \u2014 provides hooks, components, and context for seamless SSO authentication.",
   "main": "dist/index.js",
-  "module": "dist/index.mjs",
+  "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     }
   },
   "files": [
@@ -19,14 +19,15 @@
   "sideEffects": false,
   "scripts": {
     "build": "tsc",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
   },
   "peerDependencies": {
     "react": ">=18.2"
   },
   "devDependencies": {
     "@types/react": "^18.3.0",
-    "typescript": "^6.0.0"
+    "typescript": "^5.6.3"
   },
   "keywords": [
     "react",
@@ -44,5 +45,6 @@
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "type": "module"
 }