@ram_28/kf-ai-sdk 1.0.0 → 1.0.2

package/dist/auth/AuthProvider.d.ts

@@ -0,0 +1,5 @@
+import React from "react";
+import type { AuthContextValue, AuthProviderProps } from "./types";
+export declare function AuthProvider({ children, config: configOverride, onAuthChange, onError, loadingComponent, unauthenticatedComponent, skipInitialCheck, }: AuthProviderProps): React.ReactElement;
+export declare function useAuthContext(): AuthContextValue;
+//# sourceMappingURL=AuthProvider.d.ts.map

package/dist/auth/AuthProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthProvider.d.ts","sourceRoot":"","sources":["../../sdk/auth/AuthProvider.tsx"],"names":[],"mappings":"AAKA,OAAO,KAQN,MAAM,OAAO,CAAC;AAGf,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAOlB,MAAM,SAAS,CAAC;AAsBjB,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,MAAM,EAAE,cAAc,EACtB,YAAY,EACZ,OAAO,EACP,gBAAgB,EAChB,wBAAwB,EACxB,gBAAwB,GACzB,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CA2MxC;AAMD,wBAAgB,cAAc,IAAI,gBAAgB,CAMjD"}

package/dist/auth/authClient.d.ts

@@ -0,0 +1,26 @@
+import type { SessionResponse, AuthProviderName, LoginOptions, LogoutOptions } from "./types";
+/**
+ * Custom error class for authentication errors
+ */
+export declare class AuthenticationError extends Error {
+    readonly statusCode: number;
+    constructor(message: string, statusCode: number);
+}
+/**
+ * Fetch current session from the server
+ * Calls the session endpoint (default: /api/id)
+ *
+ * @throws AuthenticationError if session check fails or user is not authenticated
+ */
+export declare function fetchSession(): Promise<SessionResponse>;
+/**
+ * Initiate login flow by redirecting to the auth provider
+ * The server handles the OAuth flow and sets cookies
+ */
+export declare function initiateLogin(provider?: AuthProviderName, options?: LoginOptions): void;
+/**
+ * Logout the current user
+ * Optionally calls the logout endpoint before clearing client state
+ */
+export declare function performLogout(options?: LogoutOptions): Promise<void>;
+//# sourceMappingURL=authClient.d.ts.map

package/dist/auth/authClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authClient.d.ts","sourceRoot":"","sources":["../../sdk/auth/authClient.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,MAAM,SAAS,CAAC;AAQjB;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAKhD;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC,CAuB7D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,CAAC,EAAE,gBAAgB,EAC3B,OAAO,CAAC,EAAE,YAAY,GACrB,IAAI,CA0BN;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB1E"}

package/dist/auth/authConfig.d.ts

@@ -0,0 +1,38 @@
+import type { AuthConfig, AuthProviderName, AuthEndpointConfig } from "./types";
+/**
+ * Configure authentication settings globally
+ * @example
+ * ```ts
+ * configureAuth({
+ *   defaultProvider: "google",
+ *   autoRedirect: true,
+ *   providers: {
+ *     google: { loginPath: "/api/auth/google/login" },
+ *     microsoft: { loginPath: "/api/auth/microsoft/login" },
+ *   },
+ * });
+ * ```
+ */
+export declare function configureAuth(config: Partial<AuthConfig>): void;
+/**
+ * Add or update an auth provider configuration
+ */
+export declare function setAuthProvider(provider: AuthProviderName, config: AuthEndpointConfig): void;
+/**
+ * Get current auth configuration
+ */
+export declare function getAuthConfig(): Readonly<AuthConfig>;
+/**
+ * Get the base URL for auth endpoints
+ * Falls back to API base URL if not explicitly set
+ */
+export declare function getAuthBaseUrl(): string;
+/**
+ * Get endpoint configuration for a specific provider
+ */
+export declare function getProviderConfig(provider: AuthProviderName): AuthEndpointConfig | undefined;
+/**
+ * Reset auth configuration to defaults
+ */
+export declare function resetAuthConfig(): void;
+//# sourceMappingURL=authConfig.d.ts.map

package/dist/auth/authConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authConfig.d.ts","sourceRoot":"","sources":["../../sdk/auth/authConfig.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AA6BhF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAa/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,kBAAkB,GACzB,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,QAAQ,CAAC,UAAU,CAAC,CAEpD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,gBAAgB,GACzB,kBAAkB,GAAG,SAAS,CAEhC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/auth/index.d.ts

@@ -0,0 +1,6 @@
+export { AuthProvider } from "./AuthProvider";
+export { useAuth } from "./useAuth";
+export { configureAuth, setAuthProvider, getAuthConfig, getAuthBaseUrl, resetAuthConfig, } from "./authConfig";
+export { fetchSession, initiateLogin, performLogout, AuthenticationError, } from "./authClient";
+export type { UserDetails, SessionResponse, AuthStatus, AuthConfig, AuthProviderName, AuthEndpointConfig, AuthProviderProps, UseAuthReturn, LoginOptions, LogoutOptions, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../sdk/auth/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EACL,aAAa,EACb,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,WAAW,EACX,eAAe,EACf,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/auth/types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * User details returned from the session endpoint
+ */
+export interface UserDetails {
+    _id: string;
+    _name: string;
+    Role: string;
+    [key: string]: unknown;
+}
+/**
+ * Session response from /api/id endpoint
+ */
+export interface SessionResponse {
+    userDetails: UserDetails;
+    staticBaseUrl: string;
+    buildId: string;
+}
+/**
+ * Authentication status
+ */
+export type AuthStatus = "loading" | "authenticated" | "unauthenticated";
+/**
+ * Authentication provider type (extensible for multiple OAuth providers)
+ */
+export type AuthProviderName = "google" | "microsoft" | "github" | "custom";
+/**
+ * Auth endpoint configuration for a specific provider
+ */
+export interface AuthEndpointConfig {
+    /** Login endpoint path (e.g., "/api/auth/google/login") */
+    loginPath: string;
+    /** Optional logout endpoint path */
+    logoutPath?: string;
+    /** Optional callback endpoint path */
+    callbackPath?: string;
+}
+/**
+ * Global authentication configuration
+ */
+export interface AuthConfig {
+    /** Base URL for auth endpoints (defaults to apiBaseUrl) */
+    baseUrl?: string;
+    /** Session check endpoint (default: "/api/id") */
+    sessionEndpoint: string;
+    /** Auth provider configurations */
+    providers: Partial<Record<AuthProviderName, AuthEndpointConfig>>;
+    /** Default provider to use for login */
+    defaultProvider: AuthProviderName;
+    /** Auto-redirect to login when unauthenticated */
+    autoRedirect: boolean;
+    /** Custom redirect URL (if not using provider's login path) */
+    loginRedirectUrl?: string;
+    /** URL to redirect after successful login */
+    callbackUrl?: string;
+    /** Session check interval in milliseconds (0 to disable) */
+    sessionCheckInterval: number;
+    /** Retry configuration for session check */
+    retry: {
+        count: number;
+        delay: number;
+    };
+    /** React Query stale time for session data */
+    staleTime: number;
+}
+/**
+ * AuthProvider component props
+ */
+export interface AuthProviderProps {
+    children: React.ReactNode;
+    /** Override global config for this provider instance */
+    config?: Partial<AuthConfig>;
+    /** Callback when authentication status changes */
+    onAuthChange?: (status: AuthStatus, user: UserDetails | null) => void;
+    /** Callback on authentication error */
+    onError?: (error: Error) => void;
+    /** Custom loading component */
+    loadingComponent?: React.ReactNode;
+    /** Custom unauthenticated component (shown when autoRedirect is false) */
+    unauthenticatedComponent?: React.ReactNode;
+    /** Disable automatic session check on mount */
+    skipInitialCheck?: boolean;
+}
+/**
+ * Options for login operation
+ */
+export interface LoginOptions {
+    /** URL to redirect after successful login */
+    callbackUrl?: string;
+    /** Additional query parameters for login URL */
+    params?: Record<string, string>;
+}
+/**
+ * Options for logout operation
+ */
+export interface LogoutOptions {
+    /** URL to redirect after logout */
+    redirectUrl?: string;
+    /** Whether to call logout endpoint (default: true) */
+    callLogoutEndpoint?: boolean;
+}
+/**
+ * Return type for useAuth hook
+ */
+export interface UseAuthReturn {
+    /** Current authenticated user (null if not authenticated) */
+    user: UserDetails | null;
+    /** Static base URL from session */
+    staticBaseUrl: string | null;
+    /** Build ID from session */
+    buildId: string | null;
+    /** Current authentication status */
+    status: AuthStatus;
+    /** Convenience boolean for authenticated state */
+    isAuthenticated: boolean;
+    /** Convenience boolean for loading state */
+    isLoading: boolean;
+    /**
+     * Initiate login flow
+     * @param provider - Auth provider to use (defaults to configured default)
+     * @param options - Additional options for login
+     */
+    login: (provider?: AuthProviderName, options?: LoginOptions) => void;
+    /**
+     * Logout the current user
+     * @param options - Additional options for logout
+     */
+    logout: (options?: LogoutOptions) => Promise<void>;
+    /**
+     * Manually refresh the session
+     */
+    refreshSession: () => Promise<SessionResponse | null>;
+    /**
+     * Check if user has a specific role
+     */
+    hasRole: (role: string) => boolean;
+    /**
+     * Check if user has any of the specified roles
+     */
+    hasAnyRole: (roles: string[]) => boolean;
+    /** Last authentication error */
+    error: Error | null;
+    /** Clear the current error */
+    clearError: () => void;
+}
+/**
+ * Auth context value (internal)
+ */
+export interface AuthContextValue extends UseAuthReturn {
+    /** Internal: force re-check session */
+    _forceCheck: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/auth/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../sdk/auth/types.ts"],"names":[],"mappings":"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"}

package/dist/auth/useAuth.d.ts

@@ -0,0 +1,27 @@
+import type { UseAuthReturn } from "./types";
+/**
+ * Hook to access authentication state and operations
+ *
+ * Must be used within an AuthProvider component.
+ *
+ * @example
+ * ```tsx
+ * function UserProfile() {
+ *   const { user, isAuthenticated, logout } = useAuth();
+ *
+ *   if (!isAuthenticated) {
+ *     return <div>Please log in</div>;
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       <h1>Welcome, {user._name}</h1>
+ *       <p>Role: {user.Role}</p>
+ *       <button onClick={() => logout()}>Logout</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useAuth(): UseAuthReturn;
+//# sourceMappingURL=useAuth.d.ts.map

package/dist/auth/useAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAuth.d.ts","sourceRoot":"","sources":["../../sdk/auth/useAuth.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,OAAO,IAAI,aAAa,CAkCvC"}