@acontplus/ng-infrastructure 1.0.0

package/index.d.ts

@@ -0,0 +1,259 @@
+import * as i0 from '@angular/core';
+import { InjectionToken } from '@angular/core';
+import { HttpContextToken, HttpInterceptorFn, HttpContext, HttpRequest, HttpClient } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import { PaginationParams, PagedResult, UserData, HttpPort, HttpOptions } from '@acontplus/core';
+
+interface ITokenProvider {
+    getToken(): string | null;
+    isAuthenticated(): boolean;
+}
+declare const TOKEN_PROVIDER: InjectionToken<ITokenProvider>;
+
+declare const SKIP_NOTIFICATION: HttpContextToken<boolean>;
+declare const SHOW_NOTIFICATIONS: HttpContextToken<boolean | undefined>;
+declare const apiInterceptor: HttpInterceptorFn;
+
+declare function customUrl(): HttpContext;
+declare function skipContextHeaders(): HttpContext;
+declare function withCustomHeaders(headers: Record<string, string>): HttpContext;
+interface HttpContextConfig {
+    enableCorrelationTracking?: boolean;
+    enableRequestLogging?: boolean;
+    enableErrorLogging?: boolean;
+    customHeaders?: Record<string, string | (() => string)>;
+    clientVersion?: string;
+    tenantIdHeader?: string;
+    correlationIdHeader?: string;
+    requestIdHeader?: string;
+    timestampHeader?: string;
+    excludeUrls?: string[];
+    includeAuthToken?: boolean;
+    baseUrlInjection?: boolean;
+}
+declare const HTTP_CONTEXT_CONFIG: InjectionToken<HttpContextConfig>;
+declare const httpContextInterceptor: HttpInterceptorFn;
+interface HttpRequestLog {
+    method: string;
+    url: string;
+    originalUrl: string;
+    requestId: string;
+    correlationId: string;
+    tenantId: string;
+    timestamp: string;
+    headers: string[];
+    isCustomUrl: boolean;
+}
+interface HttpErrorLog extends HttpRequestLog {
+    status: number;
+    statusText: string;
+    message: string;
+    errorDetails: any;
+    environment: string;
+}
+declare function createHttpContextConfig(overrides?: Partial<HttpContextConfig>): HttpContextConfig;
+declare function provideHttpContext(config?: Partial<HttpContextConfig>): {
+    provide: InjectionToken<HttpContextConfig>;
+    useValue: HttpContextConfig;
+}[];
+
+/**
+ * Helper function to disable spinner for specific requests
+ * @returns HttpContext with spinner disabled
+ */
+declare function withoutSpinner(): HttpContext;
+/**
+ * Service to track active HTTP requests
+ */
+declare class ActiveRequestsTracker {
+    get count(): number;
+    add(request: HttpRequest<any>): void;
+    remove(request: HttpRequest<any>): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ActiveRequestsTracker, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ActiveRequestsTracker>;
+}
+/**
+ * Interceptor that shows/hides a loading spinner based on active HTTP requests
+ */
+declare const spinnerInterceptor: HttpInterceptorFn;
+
+interface Repository<TEntity = any, TId = number> {
+    getById?(id: TId): Observable<TEntity>;
+    getAll?(pagination?: PaginationParams): Observable<PagedResult<TEntity>>;
+    create?(entity: Partial<TEntity>): Observable<TEntity>;
+    update?(id: TId, entity: Partial<TEntity>): Observable<TEntity>;
+    remove?(id: TId): Observable<void>;
+}
+interface SearchableRepository<TEntity = any, TId = number> extends Repository<TEntity, TId> {
+    search?(query: string, pagination: PaginationParams): Observable<PagedResult<TEntity>>;
+}
+interface RepositoryConfig {
+    endpoint: string;
+    baseUrl?: string;
+    version?: string;
+}
+
+declare abstract class BaseHttpRepository {
+    protected http: HttpClient;
+    protected abstract config: RepositoryConfig;
+    protected buildUrl(path?: string): string;
+    protected get<T>(path?: string, params?: any): Observable<T>;
+    protected post<T>(path: string | undefined, body: any): Observable<T>;
+    protected put<T>(path: string | undefined, body: any): Observable<T>;
+    protected patch<T>(path: string | undefined, body: any): Observable<T>;
+    protected delete<T>(path?: string): Observable<T>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BaseHttpRepository, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<BaseHttpRepository>;
+}
+
+declare const REPOSITORY_CONFIG: InjectionToken<RepositoryConfig>;
+declare class GenericRepository<TEntity = any, TId extends string | number = number> extends BaseHttpRepository implements Repository<TEntity, TId> {
+    protected config: RepositoryConfig;
+    constructor();
+    getById(id: TId): Observable<TEntity>;
+    getAll(pagination?: PaginationParams): Observable<PagedResult<TEntity>>;
+    create(entity: Partial<TEntity>): Observable<TEntity>;
+    update(id: TId, entity: Partial<TEntity>): Observable<TEntity>;
+    remove(id: TId): Observable<void>;
+    protected buildParams(pagination?: PaginationParams, filters?: Record<string, any>): any;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GenericRepository<any, any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<GenericRepository<any, any>>;
+}
+declare class SearchableGenericRepository<TEntity = any, TId extends string | number = number> extends GenericRepository<TEntity, TId> implements SearchableRepository<TEntity, TId> {
+    search(query: string, pagination: PaginationParams): Observable<PagedResult<TEntity>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SearchableGenericRepository<any, any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SearchableGenericRepository<any, any>>;
+}
+
+declare class RepositoryFactory {
+    private http;
+    create<TEntity, TId extends string | number = number>(config: RepositoryConfig): Repository<TEntity, TId>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RepositoryFactory, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<RepositoryFactory>;
+}
+
+declare class UserRepository {
+    private readonly tokenProvider;
+    getCurrentUser(): UserData | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UserRepository, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UserRepository>;
+}
+
+declare class AngularHttpAdapter implements HttpPort {
+    private readonly http;
+    private readonly baseURL?;
+    constructor(http: HttpClient, baseURL?: string | undefined);
+    private buildOptions;
+    private request;
+    /** GET */
+    get<T>(url: string, options?: HttpOptions): Promise<T>;
+    /** POST */
+    post<T>(url: string, data?: any, options?: HttpOptions): Promise<T>;
+    /** PUT */
+    put<T>(url: string, data?: any, options?: HttpOptions): Promise<T>;
+    /** DELETE */
+    delete<T>(url: string, options?: HttpOptions): Promise<T>;
+}
+
+interface CoreConfig {
+    apiBaseUrl?: string;
+    apiTimeout?: number;
+    retryAttempts?: number;
+    retryDelay?: number;
+    enableCorrelationTracking?: boolean;
+    enableRequestLogging?: boolean;
+    enableErrorLogging?: boolean;
+    enableToastNotifications?: boolean;
+    includeAuthToken?: boolean;
+    authTokenHeader?: string;
+    enableMultiTenancy?: boolean;
+    tenantIdHeader?: string;
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    enableConsoleLogging?: boolean;
+    customHeaders?: Record<string, string | (() => string)>;
+    excludeUrls?: string[];
+    excludeMethods?: string[];
+}
+declare const CORE_CONFIG: InjectionToken<CoreConfig>;
+declare class CoreConfigService {
+    private config;
+    private environment;
+    constructor();
+    /**
+     * Initialize configuration with defaults and environment overrides
+     */
+    private initializeConfig;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): Required<CoreConfig>;
+    /**
+     * Update configuration at runtime
+     */
+    updateConfig(updates: Partial<CoreConfig>): void;
+    /**
+     * Get a specific configuration value
+     */
+    get<K extends keyof CoreConfig>(key: K): CoreConfig[K];
+    /**
+     * Check if a feature is enabled
+     */
+    isFeatureEnabled(feature: keyof CoreConfig): boolean;
+    /**
+     * Get API URL for a specific entity
+     */
+    getApiUrl(entityName?: string): string;
+    /**
+     * Check if a URL should be excluded from processing
+     */
+    shouldExcludeUrl(url: string): boolean;
+    /**
+     * Check if a method should be excluded from processing
+     */
+    shouldExcludeMethod(method: string): boolean;
+    /**
+     * Get custom headers with dynamic values resolved
+     */
+    getCustomHeaders(): Record<string, string>;
+    /**
+     * Reset configuration to defaults
+     */
+    resetConfig(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CoreConfigService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CoreConfigService>;
+}
+declare function provideCoreConfig(config?: Partial<CoreConfig>): {
+    provide: InjectionToken<CoreConfig>;
+    useValue: Partial<CoreConfig>;
+}[];
+declare function createCoreConfig(overrides?: Partial<CoreConfig>): CoreConfig;
+
+declare class CorrelationService {
+    private correlationId;
+    private readonly CORRELATION_KEY;
+    readonly currentCorrelationId: i0.Signal<string | null>;
+    getOrCreateCorrelationId(): string;
+    setCorrelationId(correlationId: string): void;
+    resetCorrelationId(): void;
+    getId(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CorrelationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CorrelationService>;
+}
+
+declare class LoggingService {
+    private environment;
+    log(level: 'info' | 'warn' | 'error', message: string, context?: any): void;
+    info(message: string, context?: any): void;
+    warn(message: string, context?: any): void;
+    error(message: string, context?: any): void;
+    logHttpRequest(log: HttpRequestLog): void;
+    logHttpError(error: HttpErrorLog): void;
+    logNetworkError(correlationId: string): void;
+    logRateLimitError(correlationId: string, url: string): void;
+    private logToExternalService;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LoggingService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<LoggingService>;
+}
+
+export { ActiveRequestsTracker, AngularHttpAdapter, BaseHttpRepository, CORE_CONFIG, CoreConfigService, CorrelationService, GenericRepository, HTTP_CONTEXT_CONFIG, LoggingService, REPOSITORY_CONFIG, RepositoryFactory, SHOW_NOTIFICATIONS, SKIP_NOTIFICATION, SearchableGenericRepository, TOKEN_PROVIDER, UserRepository, apiInterceptor, createCoreConfig, createHttpContextConfig, customUrl, httpContextInterceptor, provideCoreConfig, provideHttpContext, skipContextHeaders, spinnerInterceptor, withCustomHeaders, withoutSpinner };
+export type { CoreConfig, HttpContextConfig, HttpErrorLog, HttpRequestLog, ITokenProvider };

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@acontplus/ng-infrastructure",
+  "version": "1.0.0",
+  "description": "Acontplus Angular Infrastructure library for managing HTTP interceptors and repositories.",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@acontplus/core": "^1.0.12",
+    "@acontplus/ng-config": "^1.0.0",
+    "@acontplus/ng-notifications": "^1.0.7",
+    "@acontplus/ng-components": "^1.0.11",
+    "@angular/common": "^20.3.2",
+    "@angular/core": "^20.3.2"
+  },
+  "sideEffects": false,
+  "main": "fesm2022/acontplus-ng-infrastructure.mjs",
+  "module": "fesm2022/acontplus-ng-infrastructure.mjs",
+  "typings": "index.d.ts",
+  "files": [
+    "index.d.ts",
+    "*.d.ts",
+    "**/*.d.ts",
+    "fesm2022/**/*"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "keywords": [
+    "acontplus",
+    "angular",
+    "infrastructure",
+    "interceptors",
+    "repositories",
+    "typescript",
+    "frontend",
+    "library"
+  ],
+  "author": "Ivan Paz <ifer343@gmail.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Acontplus-S-A-S/acontplus-libs/issues"
+  },
+  "homepage": "https://github.com/Acontplus-S-A-S/acontplus-libs#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Acontplus-S-A-S/acontplus-libs.git"
+  },
+  "release": {
+    "branches": [
+      "main"
+    ]
+  },
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/acontplus-ng-infrastructure.mjs"
+    }
+  }
+}