@nuria-tech/auth-sdk 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,144 @@
+interface TokenSet {
+    accessToken: string;
+    tokenType?: string;
+    expiresIn?: number;
+    refreshToken?: string;
+    idToken?: string;
+    scope?: string;
+    expiresAt?: number;
+}
+interface Session {
+    tokens: TokenSet;
+    createdAt: number;
+}
+interface StartLoginOptions {
+    loginHint?: string;
+    scopes?: string[];
+    extraParams?: Record<string, string>;
+}
+interface StorageAdapter {
+    get(key: string): Promise<string | null> | string | null;
+    set(key: string, value: string): Promise<void> | void;
+    remove(key: string): Promise<void> | void;
+}
+interface AuthTransportRequest {
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    headers?: Record<string, string>;
+    query?: Record<string, string | undefined>;
+    body?: unknown;
+    timeoutMs?: number;
+    retries?: number;
+}
+interface AuthTransportResponse<T = unknown> {
+    status: number;
+    data: T;
+    headers: Headers;
+}
+interface AuthTransport {
+    request<T = unknown>(url: string, req?: AuthTransportRequest): Promise<AuthTransportResponse<T>>;
+}
+interface TransportInterceptor {
+    onRequest?: (url: string, req: AuthTransportRequest) => Promise<AuthTransportRequest> | AuthTransportRequest;
+    onResponse?: <T>(res: AuthTransportResponse<T>) => Promise<AuthTransportResponse<T>> | AuthTransportResponse<T>;
+}
+interface AuthConfig {
+    clientId: string;
+    authorizationEndpoint: string;
+    tokenEndpoint: string;
+    redirectUri: string;
+    scope?: string;
+    logoutEndpoint?: string;
+    userinfoEndpoint?: string;
+    storage?: StorageAdapter;
+    transport?: AuthTransport;
+    onRedirect?: (url: string) => void | Promise<void>;
+    enableRefreshToken?: boolean;
+    now?: () => number;
+}
+interface AuthClient {
+    startLogin(options?: StartLoginOptions): Promise<void>;
+    handleRedirectCallback(callbackUrl?: string): Promise<Session>;
+    getSession(): Session | null;
+    getAccessToken(): Promise<string | null>;
+    logout(options?: {
+        returnTo?: string;
+    }): Promise<void>;
+    isAuthenticated(): boolean;
+    onAuthStateChanged(handler: (session: Session | null) => void): () => void;
+    getUserinfo(): Promise<Record<string, unknown>>;
+}
+
+declare function createAuthClient(config: AuthConfig): AuthClient;
+
+declare class MemoryStorageAdapter implements StorageAdapter {
+    private store;
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+}
+
+declare class WebStorageAdapter implements StorageAdapter {
+    private readonly storage;
+    constructor(storage: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>);
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+}
+
+interface CookieStorageCallbacks {
+    getCookie(name: string): string | null | Promise<string | null>;
+    setCookie(name: string, value: string): void | Promise<void>;
+    removeCookie(name: string): void | Promise<void>;
+}
+declare class CookieStorageAdapter implements StorageAdapter {
+    private readonly callbacks;
+    constructor(callbacks: CookieStorageCallbacks);
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+
+interface BrowserCookieStorageOptions {
+    domain?: string;
+    path?: string;
+    sameSite?: 'strict' | 'lax' | 'none';
+    secure?: boolean;
+}
+declare function createBrowserCookieStorage(options?: BrowserCookieStorageOptions): StorageAdapter;
+
+interface FetchTransportOptions {
+    fetchFn?: typeof fetch;
+    timeoutMs?: number;
+    retries?: number;
+    interceptors?: TransportInterceptor[];
+}
+declare class FetchAuthTransport implements AuthTransport {
+    private readonly fetchFn;
+    private readonly timeoutMs?;
+    private readonly retries;
+    private readonly interceptors;
+    constructor(options?: FetchTransportOptions);
+    request<T = unknown>(url: string, req?: AuthTransportRequest): Promise<AuthTransportResponse<T>>;
+    private withQuery;
+    private parseBody;
+}
+
+declare enum AuthErrorCode {
+    INVALID_CONFIG = "INVALID_CONFIG",
+    STATE_MISMATCH = "STATE_MISMATCH",
+    CALLBACK_ERROR = "CALLBACK_ERROR",
+    TOKEN_EXCHANGE_FAILED = "TOKEN_EXCHANGE_FAILED",
+    REFRESH_FAILED = "REFRESH_FAILED",
+    STORAGE_ERROR = "STORAGE_ERROR",
+    MISSING_CODE = "MISSING_CODE",
+    MISSING_STATE = "MISSING_STATE",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    HTTP_ERROR = "HTTP_ERROR"
+}
+declare class AuthError extends Error {
+    readonly code: AuthErrorCode;
+    readonly cause?: unknown | undefined;
+    constructor(code: AuthErrorCode, message: string, cause?: unknown | undefined);
+}
+
+export { type AuthClient, type AuthConfig, AuthError, AuthErrorCode, type AuthTransport, type AuthTransportRequest, type AuthTransportResponse, type BrowserCookieStorageOptions, CookieStorageAdapter, FetchAuthTransport, MemoryStorageAdapter, type Session, type StartLoginOptions, type StorageAdapter, type TokenSet, type TransportInterceptor, WebStorageAdapter, createAuthClient, createBrowserCookieStorage };

package/dist/index.d.ts

@@ -0,0 +1,144 @@
+interface TokenSet {
+    accessToken: string;
+    tokenType?: string;
+    expiresIn?: number;
+    refreshToken?: string;
+    idToken?: string;
+    scope?: string;
+    expiresAt?: number;
+}
+interface Session {
+    tokens: TokenSet;
+    createdAt: number;
+}
+interface StartLoginOptions {
+    loginHint?: string;
+    scopes?: string[];
+    extraParams?: Record<string, string>;
+}
+interface StorageAdapter {
+    get(key: string): Promise<string | null> | string | null;
+    set(key: string, value: string): Promise<void> | void;
+    remove(key: string): Promise<void> | void;
+}
+interface AuthTransportRequest {
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    headers?: Record<string, string>;
+    query?: Record<string, string | undefined>;
+    body?: unknown;
+    timeoutMs?: number;
+    retries?: number;
+}
+interface AuthTransportResponse<T = unknown> {
+    status: number;
+    data: T;
+    headers: Headers;
+}
+interface AuthTransport {
+    request<T = unknown>(url: string, req?: AuthTransportRequest): Promise<AuthTransportResponse<T>>;
+}
+interface TransportInterceptor {
+    onRequest?: (url: string, req: AuthTransportRequest) => Promise<AuthTransportRequest> | AuthTransportRequest;
+    onResponse?: <T>(res: AuthTransportResponse<T>) => Promise<AuthTransportResponse<T>> | AuthTransportResponse<T>;
+}
+interface AuthConfig {
+    clientId: string;
+    authorizationEndpoint: string;
+    tokenEndpoint: string;
+    redirectUri: string;
+    scope?: string;
+    logoutEndpoint?: string;
+    userinfoEndpoint?: string;
+    storage?: StorageAdapter;
+    transport?: AuthTransport;
+    onRedirect?: (url: string) => void | Promise<void>;
+    enableRefreshToken?: boolean;
+    now?: () => number;
+}
+interface AuthClient {
+    startLogin(options?: StartLoginOptions): Promise<void>;
+    handleRedirectCallback(callbackUrl?: string): Promise<Session>;
+    getSession(): Session | null;
+    getAccessToken(): Promise<string | null>;
+    logout(options?: {
+        returnTo?: string;
+    }): Promise<void>;
+    isAuthenticated(): boolean;
+    onAuthStateChanged(handler: (session: Session | null) => void): () => void;
+    getUserinfo(): Promise<Record<string, unknown>>;
+}
+
+declare function createAuthClient(config: AuthConfig): AuthClient;
+
+declare class MemoryStorageAdapter implements StorageAdapter {
+    private store;
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+}
+
+declare class WebStorageAdapter implements StorageAdapter {
+    private readonly storage;
+    constructor(storage: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>);
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+}
+
+interface CookieStorageCallbacks {
+    getCookie(name: string): string | null | Promise<string | null>;
+    setCookie(name: string, value: string): void | Promise<void>;
+    removeCookie(name: string): void | Promise<void>;
+}
+declare class CookieStorageAdapter implements StorageAdapter {
+    private readonly callbacks;
+    constructor(callbacks: CookieStorageCallbacks);
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+
+interface BrowserCookieStorageOptions {
+    domain?: string;
+    path?: string;
+    sameSite?: 'strict' | 'lax' | 'none';
+    secure?: boolean;
+}
+declare function createBrowserCookieStorage(options?: BrowserCookieStorageOptions): StorageAdapter;
+
+interface FetchTransportOptions {
+    fetchFn?: typeof fetch;
+    timeoutMs?: number;
+    retries?: number;
+    interceptors?: TransportInterceptor[];
+}
+declare class FetchAuthTransport implements AuthTransport {
+    private readonly fetchFn;
+    private readonly timeoutMs?;
+    private readonly retries;
+    private readonly interceptors;
+    constructor(options?: FetchTransportOptions);
+    request<T = unknown>(url: string, req?: AuthTransportRequest): Promise<AuthTransportResponse<T>>;
+    private withQuery;
+    private parseBody;
+}
+
+declare enum AuthErrorCode {
+    INVALID_CONFIG = "INVALID_CONFIG",
+    STATE_MISMATCH = "STATE_MISMATCH",
+    CALLBACK_ERROR = "CALLBACK_ERROR",
+    TOKEN_EXCHANGE_FAILED = "TOKEN_EXCHANGE_FAILED",
+    REFRESH_FAILED = "REFRESH_FAILED",
+    STORAGE_ERROR = "STORAGE_ERROR",
+    MISSING_CODE = "MISSING_CODE",
+    MISSING_STATE = "MISSING_STATE",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    HTTP_ERROR = "HTTP_ERROR"
+}
+declare class AuthError extends Error {
+    readonly code: AuthErrorCode;
+    readonly cause?: unknown | undefined;
+    constructor(code: AuthErrorCode, message: string, cause?: unknown | undefined);
+}
+
+export { type AuthClient, type AuthConfig, AuthError, AuthErrorCode, type AuthTransport, type AuthTransportRequest, type AuthTransportResponse, type BrowserCookieStorageOptions, CookieStorageAdapter, FetchAuthTransport, MemoryStorageAdapter, type Session, type StartLoginOptions, type StorageAdapter, type TokenSet, type TransportInterceptor, WebStorageAdapter, createAuthClient, createBrowserCookieStorage };