@lenan-soft/auth 1.0.1

package/dist/index.d.cts

@@ -0,0 +1,129 @@
+/**
+ * JWT payload structure
+ */
+interface JwtPayload {
+    /** User ID (subject) */
+    sub: string;
+    /** User email */
+    email: string;
+    /** Issued at timestamp */
+    iat?: number;
+    /** Expiration timestamp */
+    exp?: number;
+}
+/**
+ * Token response containing access and refresh tokens
+ */
+interface AuthTokens {
+    /** Short-lived access token */
+    accessToken: string;
+    /** Long-lived refresh token */
+    refreshToken: string;
+}
+/**
+ * Base user interface - minimal fields required by the auth system
+ * Consumers should extend this with their own user properties
+ */
+interface BaseUser {
+    /** Unique user identifier */
+    id: string;
+    /** User email address */
+    email: string;
+}
+/**
+ * User with password hash - used internally for authentication
+ */
+interface UserWithPassword extends BaseUser {
+    /** Bcrypt hashed password */
+    passwordHash: string;
+}
+/**
+ * User with refresh token - used for token refresh operations
+ */
+interface UserWithRefreshToken extends BaseUser {
+    /** Hashed refresh token (nullable when logged out) */
+    hashedRefreshToken: string | null;
+}
+/**
+ * Full auth user interface combining all auth-related fields
+ */
+interface AuthUser extends BaseUser {
+    passwordHash: string;
+    hashedRefreshToken: string | null;
+}
+/**
+ * Login credentials
+ */
+interface LoginCredentials {
+    email: string;
+    password: string;
+}
+/**
+ * Registration data
+ */
+interface RegisterData {
+    email: string;
+    password: string;
+}
+/**
+ * Auth state for frontend applications
+ */
+interface AuthState<TUser extends BaseUser = BaseUser> {
+    /** Current authenticated user or null */
+    user: TUser | null;
+    /** Current tokens or null */
+    tokens: AuthTokens | null;
+    /** Whether auth state is being loaded/validated */
+    isLoading: boolean;
+    /** Whether user is authenticated */
+    isAuthenticated: boolean;
+    /** Auth error if any */
+    error: string | null;
+}
+/**
+ * Token storage interface for frontend applications
+ * Implement this to use different storage backends (localStorage, SecureStore, etc.)
+ */
+interface TokenStorage {
+    getItem(key: string): Promise<string | null> | string | null;
+    setItem(key: string, value: string): Promise<void> | void;
+    removeItem(key: string): Promise<void> | void;
+}
+/**
+ * Auth client configuration for frontend HTTP client
+ */
+interface AuthClientConfig {
+    /** Base URL for auth API endpoints */
+    baseUrl: string;
+    /** Token storage implementation */
+    tokenStorage: TokenStorage;
+    /** Custom headers to include in requests */
+    headers?: Record<string, string>;
+    /** Access token storage key (default: 'lenan_access_token') */
+    accessTokenKey?: string;
+    /** Refresh token storage key (default: 'lenan_refresh_token') */
+    refreshTokenKey?: string;
+}
+/**
+ * Auth API endpoints configuration
+ */
+interface AuthEndpoints {
+    login: string;
+    register: string;
+    refresh: string;
+    logout: string;
+    me: string;
+}
+/**
+ * Default auth endpoints
+ */
+declare const DEFAULT_AUTH_ENDPOINTS: AuthEndpoints;
+/**
+ * Default token storage keys
+ */
+declare const TOKEN_STORAGE_KEYS: {
+    readonly ACCESS_TOKEN: "lenan_access_token";
+    readonly REFRESH_TOKEN: "lenan_refresh_token";
+};
+
+export { type AuthClientConfig, type AuthEndpoints, type AuthState, type AuthTokens, type AuthUser, type BaseUser, DEFAULT_AUTH_ENDPOINTS, type JwtPayload, type LoginCredentials, type RegisterData, TOKEN_STORAGE_KEYS, type TokenStorage, type UserWithPassword, type UserWithRefreshToken };

package/dist/index.d.ts

@@ -0,0 +1,129 @@
+/**
+ * JWT payload structure
+ */
+interface JwtPayload {
+    /** User ID (subject) */
+    sub: string;
+    /** User email */
+    email: string;
+    /** Issued at timestamp */
+    iat?: number;
+    /** Expiration timestamp */
+    exp?: number;
+}
+/**
+ * Token response containing access and refresh tokens
+ */
+interface AuthTokens {
+    /** Short-lived access token */
+    accessToken: string;
+    /** Long-lived refresh token */
+    refreshToken: string;
+}
+/**
+ * Base user interface - minimal fields required by the auth system
+ * Consumers should extend this with their own user properties
+ */
+interface BaseUser {
+    /** Unique user identifier */
+    id: string;
+    /** User email address */
+    email: string;
+}
+/**
+ * User with password hash - used internally for authentication
+ */
+interface UserWithPassword extends BaseUser {
+    /** Bcrypt hashed password */
+    passwordHash: string;
+}
+/**
+ * User with refresh token - used for token refresh operations
+ */
+interface UserWithRefreshToken extends BaseUser {
+    /** Hashed refresh token (nullable when logged out) */
+    hashedRefreshToken: string | null;
+}
+/**
+ * Full auth user interface combining all auth-related fields
+ */
+interface AuthUser extends BaseUser {
+    passwordHash: string;
+    hashedRefreshToken: string | null;
+}
+/**
+ * Login credentials
+ */
+interface LoginCredentials {
+    email: string;
+    password: string;
+}
+/**
+ * Registration data
+ */
+interface RegisterData {
+    email: string;
+    password: string;
+}
+/**
+ * Auth state for frontend applications
+ */
+interface AuthState<TUser extends BaseUser = BaseUser> {
+    /** Current authenticated user or null */
+    user: TUser | null;
+    /** Current tokens or null */
+    tokens: AuthTokens | null;
+    /** Whether auth state is being loaded/validated */
+    isLoading: boolean;
+    /** Whether user is authenticated */
+    isAuthenticated: boolean;
+    /** Auth error if any */
+    error: string | null;
+}
+/**
+ * Token storage interface for frontend applications
+ * Implement this to use different storage backends (localStorage, SecureStore, etc.)
+ */
+interface TokenStorage {
+    getItem(key: string): Promise<string | null> | string | null;
+    setItem(key: string, value: string): Promise<void> | void;
+    removeItem(key: string): Promise<void> | void;
+}
+/**
+ * Auth client configuration for frontend HTTP client
+ */
+interface AuthClientConfig {
+    /** Base URL for auth API endpoints */
+    baseUrl: string;
+    /** Token storage implementation */
+    tokenStorage: TokenStorage;
+    /** Custom headers to include in requests */
+    headers?: Record<string, string>;
+    /** Access token storage key (default: 'lenan_access_token') */
+    accessTokenKey?: string;
+    /** Refresh token storage key (default: 'lenan_refresh_token') */
+    refreshTokenKey?: string;
+}
+/**
+ * Auth API endpoints configuration
+ */
+interface AuthEndpoints {
+    login: string;
+    register: string;
+    refresh: string;
+    logout: string;
+    me: string;
+}
+/**
+ * Default auth endpoints
+ */
+declare const DEFAULT_AUTH_ENDPOINTS: AuthEndpoints;
+/**
+ * Default token storage keys
+ */
+declare const TOKEN_STORAGE_KEYS: {
+    readonly ACCESS_TOKEN: "lenan_access_token";
+    readonly REFRESH_TOKEN: "lenan_refresh_token";
+};
+
+export { type AuthClientConfig, type AuthEndpoints, type AuthState, type AuthTokens, type AuthUser, type BaseUser, DEFAULT_AUTH_ENDPOINTS, type JwtPayload, type LoginCredentials, type RegisterData, TOKEN_STORAGE_KEYS, type TokenStorage, type UserWithPassword, type UserWithRefreshToken };

package/dist/index.js

@@ -0,0 +1,17 @@
+// src/shared/types.ts
+var DEFAULT_AUTH_ENDPOINTS = {
+  login: "/auth/login",
+  register: "/auth/register",
+  refresh: "/auth/refresh",
+  logout: "/auth/logout",
+  me: "/auth/me"
+};
+var TOKEN_STORAGE_KEYS = {
+  ACCESS_TOKEN: "lenan_access_token",
+  REFRESH_TOKEN: "lenan_refresh_token"
+};
+export {
+  DEFAULT_AUTH_ENDPOINTS,
+  TOKEN_STORAGE_KEYS
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/types.ts"],"sourcesContent":["/**\n * JWT payload structure\n */\nexport interface JwtPayload {\n  /** User ID (subject) */\n  sub: string;\n  /** User email */\n  email: string;\n  /** Issued at timestamp */\n  iat?: number;\n  /** Expiration timestamp */\n  exp?: number;\n}\n\n/**\n * Token response containing access and refresh tokens\n */\nexport interface AuthTokens {\n  /** Short-lived access token */\n  accessToken: string;\n  /** Long-lived refresh token */\n  refreshToken: string;\n}\n\n/**\n * Base user interface - minimal fields required by the auth system\n * Consumers should extend this with their own user properties\n */\nexport interface BaseUser {\n  /** Unique user identifier */\n  id: string;\n  /** User email address */\n  email: string;\n}\n\n/**\n * User with password hash - used internally for authentication\n */\nexport interface UserWithPassword extends BaseUser {\n  /** Bcrypt hashed password */\n  passwordHash: string;\n}\n\n/**\n * User with refresh token - used for token refresh operations\n */\nexport interface UserWithRefreshToken extends BaseUser {\n  /** Hashed refresh token (nullable when logged out) */\n  hashedRefreshToken: string | null;\n}\n\n/**\n * Full auth user interface combining all auth-related fields\n */\nexport interface AuthUser extends BaseUser {\n  passwordHash: string;\n  hashedRefreshToken: string | null;\n}\n\n/**\n * Login credentials\n */\nexport interface LoginCredentials {\n  email: string;\n  password: string;\n}\n\n/**\n * Registration data\n */\nexport interface RegisterData {\n  email: string;\n  password: string;\n}\n\n/**\n * Auth state for frontend applications\n */\nexport interface AuthState<TUser extends BaseUser = BaseUser> {\n  /** Current authenticated user or null */\n  user: TUser | null;\n  /** Current tokens or null */\n  tokens: AuthTokens | null;\n  /** Whether auth state is being loaded/validated */\n  isLoading: boolean;\n  /** Whether user is authenticated */\n  isAuthenticated: boolean;\n  /** Auth error if any */\n  error: string | null;\n}\n\n/**\n * Token storage interface for frontend applications\n * Implement this to use different storage backends (localStorage, SecureStore, etc.)\n */\nexport interface TokenStorage {\n  getItem(key: string): Promise<string | null> | string | null;\n  setItem(key: string, value: string): Promise<void> | void;\n  removeItem(key: string): Promise<void> | void;\n}\n\n/**\n * Auth client configuration for frontend HTTP client\n */\nexport interface AuthClientConfig {\n  /** Base URL for auth API endpoints */\n  baseUrl: string;\n  /** Token storage implementation */\n  tokenStorage: TokenStorage;\n  /** Custom headers to include in requests */\n  headers?: Record<string, string>;\n  /** Access token storage key (default: 'lenan_access_token') */\n  accessTokenKey?: string;\n  /** Refresh token storage key (default: 'lenan_refresh_token') */\n  refreshTokenKey?: string;\n}\n\n/**\n * Auth API endpoints configuration\n */\nexport interface AuthEndpoints {\n  login: string;\n  register: string;\n  refresh: string;\n  logout: string;\n  me: string;\n}\n\n/**\n * Default auth endpoints\n */\nexport const DEFAULT_AUTH_ENDPOINTS: AuthEndpoints = {\n  login: \"/auth/login\",\n  register: \"/auth/register\",\n  refresh: \"/auth/refresh\",\n  logout: \"/auth/logout\",\n  me: \"/auth/me\",\n};\n\n/**\n * Default token storage keys\n */\nexport const TOKEN_STORAGE_KEYS = {\n  ACCESS_TOKEN: \"lenan_access_token\",\n  REFRESH_TOKEN: \"lenan_refresh_token\",\n} as const;\n"],"mappings":";AAmIO,IAAM,yBAAwC;AAAA,EACnD,OAAO;AAAA,EACP,UAAU;AAAA,EACV,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,IAAI;AACN;AAKO,IAAM,qBAAqB;AAAA,EAChC,cAAc;AAAA,EACd,eAAe;AACjB;","names":[]}