u-mapsnpm 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,636 @@
+# u-mapsnpm
+
+Core utilities, Angular infrastructure, and shared types for the U-Maps platform.
+
+## Installation
+
+```bash
+npm install u-mapsnpm
+```
+
+### Peer Dependencies
+
+Angular features require:
+
+```bash
+npm install @angular/core @angular/common rxjs
+```
+
+---
+
+## Entry Points
+
+```ts
+import { ... } from 'u-maps';          // Core utilities (framework-agnostic)
+import { ... } from 'u-maps/angular';  // Angular services, helpers, tokens
+import type { ... } from 'u-maps/types'; // Shared TypeScript interfaces
+```
+
+---
+
+## Core Utilities (`u-maps`)
+
+Framework-agnostic utility functions. No Angular dependency required.
+
+### String Utilities
+
+#### `capitalize(value: string): string`
+
+Capitalizes the first letter of a string.
+
+```ts
+import { capitalize } from 'u-maps';
+
+capitalize('hello');  // 'Hello'
+capitalize('');       // ''
+```
+
+#### `truncate(value: string, maxLength: number, suffix?: string): string`
+
+Truncates a string to a maximum length, appending a suffix (default `'...'`).
+
+```ts
+import { truncate } from 'u-maps';
+
+truncate('Hello World', 8);        // 'Hello...'
+truncate('Hello World', 8, '…');   // 'Hello W…'
+truncate('Short', 10);             // 'Short'
+```
+
+#### `toKebabCase(value: string): string`
+
+Converts a string to kebab-case.
+
+```ts
+import { toKebabCase } from 'u-maps';
+
+toKebabCase('helloWorld');    // 'hello-world'
+toKebabCase('Hello World');   // 'hello-world'
+toKebabCase('some_value');    // 'some-value'
+```
+
+#### `toCamelCase(value: string): string`
+
+Converts a string to camelCase.
+
+```ts
+import { toCamelCase } from 'u-maps';
+
+toCamelCase('hello-world');   // 'helloWorld'
+toCamelCase('Hello World');   // 'helloWorld'
+toCamelCase('some_value');    // 'someValue'
+```
+
+### Number Utilities
+
+#### `formatCurrency(value: number, locale?: string, currency?: string): string`
+
+Formats a number as a currency string using `Intl.NumberFormat`.
+
+```ts
+import { formatCurrency } from 'u-maps';
+
+formatCurrency(1234.5);                    // '$1,234.50'
+formatCurrency(1234.5, 'uz-UZ', 'UZS');   // locale-specific format
+```
+
+#### `clamp(value: number, min: number, max: number): number`
+
+Clamps a number between min and max bounds.
+
+```ts
+import { clamp } from 'u-maps';
+
+clamp(15, 0, 10);   // 10
+clamp(-5, 0, 10);   // 0
+clamp(5, 0, 10);    // 5
+```
+
+#### `roundTo(value: number, decimals: number): number`
+
+Rounds a number to the specified number of decimal places.
+
+```ts
+import { roundTo } from 'u-maps';
+
+roundTo(3.14159, 2);   // 3.14
+roundTo(3.14159, 0);   // 3
+```
+
+### Date Utilities
+
+#### `formatDate(date: Date, locale?: string, options?: Intl.DateTimeFormatOptions): string`
+
+Formats a Date to a locale string. Defaults to `'en-US'` with `year: 'numeric', month: 'short', day: 'numeric'`.
+
+```ts
+import { formatDate } from 'u-maps';
+
+formatDate(new Date('2025-03-25'));                              // 'Mar 25, 2025'
+formatDate(new Date('2025-03-25'), 'uz-UZ', { dateStyle: 'long' });
+```
+
+#### `isToday(date: Date): boolean`
+
+Returns `true` if the given date is today.
+
+```ts
+import { isToday } from 'u-maps';
+
+isToday(new Date());  // true
+```
+
+#### `daysBetween(a: Date, b: Date): number`
+
+Returns the number of full days between two dates.
+
+```ts
+import { daysBetween } from 'u-maps';
+
+daysBetween(new Date('2025-01-01'), new Date('2025-01-10'));  // 9
+```
+
+---
+
+## Angular Layer (`u-maps/angular`)
+
+Angular infrastructure utilities. Requires `@angular/core >= 19` and `rxjs >= 7`.
+
+### Services
+
+#### `HttpService`
+
+Typed HTTP wrapper around Angular's `HttpClient`. Automatically prepends the `API_URL` token to relative paths. All responses are typed with `ApiResponse<T>`.
+
+```ts
+import { HttpService } from 'u-maps/angular';
+
+@Injectable({ providedIn: 'root' })
+export class UserService {
+  private http = inject(HttpService);
+
+  getUser(id: string) {
+    return this.http.get<User>(`/users/${id}`);
+    // Calls: https://api.example.com/users/123
+    // Returns: Observable<ApiResponse<User>>
+  }
+
+  getUsers(page: number) {
+    return this.http.getList<User>('/users', { params: { page } });
+    // Returns: Observable<PaginatedResponse<User>>
+  }
+
+  createUser(body: CreateUserDto) {
+    return this.http.post<User>('/users', body);
+  }
+
+  updateUser(id: string, body: Partial<User>) {
+    return this.http.put<User>(`/users/${id}`, body);
+  }
+
+  patchUser(id: string, body: Partial<User>) {
+    return this.http.patch<User>(`/users/${id}`, body);
+  }
+
+  deleteUser(id: string) {
+    return this.http.delete<void>(`/users/${id}`);
+  }
+}
+```
+
+**Methods:**
+
+| Method | Signature | Returns |
+|--------|-----------|---------|
+| `get` | `get<T>(url, options?)` | `Observable<ApiResponse<T>>` |
+| `getList` | `getList<T>(url, options?)` | `Observable<PaginatedResponse<T>>` |
+| `post` | `post<T>(url, body, options?)` | `Observable<ApiResponse<T>>` |
+| `put` | `put<T>(url, body, options?)` | `Observable<ApiResponse<T>>` |
+| `patch` | `patch<T>(url, body, options?)` | `Observable<ApiResponse<T>>` |
+| `delete` | `delete<T>(url, options?)` | `Observable<ApiResponse<T>>` |
+
+**RequestOptions:**
+
+```ts
+interface RequestOptions {
+  params?: Record<string, string | number | boolean>;
+  headers?: Record<string, string>;
+}
+```
+
+**Extending HttpService:**
+
+You can extend `HttpService` for domain-specific services:
+
+```ts
+@Injectable({ providedIn: 'root' })
+export class UserService extends HttpService {
+  getUsers() {
+    return this.get<User[]>('/users');
+  }
+}
+```
+
+Absolute URLs bypass the `API_URL` prefix:
+
+```ts
+this.http.get<Data>('https://external-api.com/data'); // No prefix
+```
+
+#### `BaseService`
+
+Abstract service with lifecycle management. Extend this for services that need cleanup.
+
+```ts
+import { BaseService } from 'u-maps/angular';
+
+@Injectable({ providedIn: 'root' })
+export class WebSocketService extends BaseService {
+  private connection$ = new Subject<Message>();
+
+  connect(url: string) {
+    someWebSocket(url).pipe(
+      takeUntil(this.destroy$),  // Auto-cleanup on destroy
+    ).subscribe(msg => this.connection$.next(msg));
+  }
+}
+```
+
+**Protected members:**
+
+| Member | Type | Description |
+|--------|------|-------------|
+| `destroyRef` | `DestroyRef` | Angular destroy reference |
+| `destroy$` | `Subject<void>` | Emits and completes on destroy |
+
+### Helpers
+
+#### `injectDestroy(): Subject<void>`
+
+Creates a `Subject<void>` that emits and completes when the injection context is destroyed. Must be called inside an injection context.
+
+```ts
+import { injectDestroy } from 'u-maps/angular';
+
+@Component({ ... })
+export class MyComponent {
+  private destroy$ = injectDestroy();
+
+  ngOnInit() {
+    this.someService.data$.pipe(
+      takeUntil(this.destroy$),
+    ).subscribe(data => { ... });
+  }
+}
+```
+
+#### `takeUntilDestroyed<T>(): MonoTypeOperatorFunction<T>`
+
+RxJS operator version of `injectDestroy`. Must be called inside an injection context (field initializer, constructor).
+
+```ts
+import { takeUntilDestroyed } from 'u-maps/angular';
+
+@Component({ ... })
+export class MyComponent {
+  private untilDestroyed = takeUntilDestroyed();
+
+  ngOnInit() {
+    this.someService.data$.pipe(
+      this.untilDestroyed,
+    ).subscribe(data => { ... });
+  }
+}
+```
+
+#### `mapResponse<T>(): OperatorFunction<T, ResponseResult<T>>`
+
+Maps an Observable into a discriminated success/error union. The stream never errors — errors are caught and wrapped.
+
+```ts
+import { mapResponse } from 'u-maps/angular';
+
+this.http.get<User[]>('/users').pipe(
+  mapResponse(),
+).subscribe(result => {
+  if (result.success) {
+    console.log(result.data); // User[]
+  } else {
+    console.error(result.error); // unknown
+  }
+});
+```
+
+**ResponseResult type:**
+
+```ts
+type ResponseResult<T> =
+  | { success: true; data: T }
+  | { success: false; error: unknown };
+```
+
+#### `handleError<T>(fallback: T): OperatorFunction<T, T>`
+
+Catches errors and replaces the stream with a fallback value.
+
+```ts
+import { handleError } from 'u-maps/angular';
+
+this.http.get<User[]>('/users').pipe(
+  handleError([]),             // On error, emit empty array
+).subscribe(users => { ... }); // Always gets User[]
+```
+
+#### `createLoadingState<T>(initialValue?: T | null): LoadingState<T>`
+
+Creates a reactive loading-state triple using Angular signals. Useful for managing async data fetch patterns.
+
+```ts
+import { createLoadingState } from 'u-maps/angular';
+
+@Component({
+  template: `
+    @if (state.loading()) {
+      <spinner />
+    }
+    @if (state.error(); as error) {
+      <error-message [text]="error" />
+    }
+    @if (state.data(); as users) {
+      <user-list [users]="users" />
+    }
+  `
+})
+export class UsersComponent {
+  state = createLoadingState<User[]>();
+
+  constructor() {
+    this.load();
+  }
+
+  load() {
+    this.state.setLoading(true);
+    inject(HttpService).get<User[]>('/users').subscribe({
+      next: res => this.state.set(res.data),
+      error: err => this.state.setError(err.message),
+    });
+  }
+}
+```
+
+**LoadingState interface:**
+
+| Member | Type | Description |
+|--------|------|-------------|
+| `data` | `Signal<T \| null>` | Current data (read-only signal) |
+| `loading` | `Signal<boolean>` | Loading flag (read-only signal) |
+| `error` | `Signal<string \| null>` | Error message (read-only signal) |
+| `set(value)` | `(T) => void` | Sets data, clears loading and error |
+| `setError(msg)` | `(string) => void` | Sets error, clears loading |
+| `setLoading(flag)` | `(boolean) => void` | Sets loading, clears error if `true` |
+| `reset()` | `() => void` | Resets to initial state |
+
+### Injection Tokens
+
+#### `API_URL`
+
+`InjectionToken<string>` — base URL for all HTTP requests made through `HttpService`.
+
+```ts
+import { API_URL } from 'u-maps/angular';
+
+// app.config.ts
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideHttpClient(),
+    { provide: API_URL, useValue: 'https://api.u-maps.uz/v1' },
+  ],
+};
+```
+
+If `API_URL` is not provided, `HttpService` uses an empty string (relative paths stay relative).
+
+#### `APP_CONFIG`
+
+`InjectionToken<AppConfig>` — application-wide configuration object.
+
+```ts
+import { APP_CONFIG, type AppConfig } from 'u-maps/angular';
+
+// Extend for your project
+interface MyConfig extends AppConfig {
+  mapboxToken: string;
+  sentryDsn: string;
+}
+
+const config: MyConfig = {
+  apiUrl: 'https://api.u-maps.uz/v1',
+  production: true,
+  mapboxToken: '...',
+  sentryDsn: '...',
+};
+
+// app.config.ts
+providers: [
+  { provide: APP_CONFIG, useValue: config },
+]
+
+// Any service/component
+export class MapService {
+  private config = inject(APP_CONFIG) as MyConfig;
+}
+```
+
+**AppConfig interface:**
+
+```ts
+interface AppConfig {
+  apiUrl: string;
+  production: boolean;
+  [key: string]: unknown;   // extensible
+}
+```
+
+---
+
+## Shared Types (`u-maps/types`)
+
+TypeScript interfaces for API contracts and entity shapes. No runtime code.
+
+### API Interfaces
+
+#### `ApiResponse<T>`
+
+Standard API response envelope.
+
+```ts
+interface ApiResponse<T> {
+  data: T;
+  meta?: ApiMeta;
+}
+```
+
+#### `PaginatedResponse<T>`
+
+Paginated API response. Extends `ApiResponse<T[]>` with required pagination metadata.
+
+```ts
+interface PaginatedResponse<T> extends ApiResponse<T[]> {
+  meta: ApiMeta & PaginationMeta;
+}
+```
+
+#### `ApiMeta`
+
+```ts
+interface ApiMeta {
+  timestamp: string;
+  requestId?: string;
+}
+```
+
+#### `PaginationMeta`
+
+```ts
+interface PaginationMeta {
+  page: number;
+  pageSize: number;
+  totalItems: number;
+  totalPages: number;
+}
+```
+
+#### `ApiError`
+
+```ts
+interface ApiError {
+  code: string;
+  message: string;
+  details?: Record<string, unknown>;
+}
+```
+
+### Entity Interfaces
+
+#### `BaseEntity`
+
+```ts
+interface BaseEntity {
+  id: string;
+  createdAt: string;
+  updatedAt: string;
+}
+```
+
+#### `Identifiable`
+
+```ts
+interface Identifiable {
+  id: string;
+}
+```
+
+#### `SoftDeletable`
+
+```ts
+interface SoftDeletable {
+  deletedAt?: string;
+  isDeleted: boolean;
+}
+```
+
+**Usage:**
+
+```ts
+import type { BaseEntity, SoftDeletable } from 'u-maps/types';
+
+interface User extends BaseEntity, SoftDeletable {
+  name: string;
+  email: string;
+}
+```
+
+---
+
+## Full Setup Example
+
+```ts
+// app.config.ts
+import { ApplicationConfig } from '@angular/core';
+import { provideHttpClient } from '@angular/common/http';
+import { API_URL, APP_CONFIG, type AppConfig } from 'u-maps/angular';
+
+const config: AppConfig = {
+  apiUrl: 'https://api.u-maps.uz/v1',
+  production: true,
+};
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideHttpClient(),
+    { provide: API_URL, useValue: config.apiUrl },
+    { provide: APP_CONFIG, useValue: config },
+  ],
+};
+```
+
+```ts
+// user.service.ts
+import { Injectable, inject } from '@angular/core';
+import { HttpService } from 'u-maps/angular';
+import type { BaseEntity } from 'u-maps/types';
+
+interface User extends BaseEntity {
+  name: string;
+  email: string;
+}
+
+@Injectable({ providedIn: 'root' })
+export class UserService {
+  private http = inject(HttpService);
+
+  getAll(page: number)    { return this.http.getList<User>('/users', { params: { page } }); }
+  getById(id: string)     { return this.http.get<User>(`/users/${id}`); }
+  create(body: Partial<User>) { return this.http.post<User>('/users', body); }
+  update(id: string, body: Partial<User>) { return this.http.put<User>(`/users/${id}`, body); }
+  remove(id: string)      { return this.http.delete<void>(`/users/${id}`); }
+}
+```
+
+```ts
+// users.component.ts
+import { Component, inject } from '@angular/core';
+import { createLoadingState, handleError } from 'u-maps/angular';
+import { UserService } from './user.service';
+
+@Component({ ... })
+export class UsersComponent {
+  private userService = inject(UserService);
+  state = createLoadingState<User[]>();
+
+  constructor() {
+    this.load();
+  }
+
+  load() {
+    this.state.setLoading(true);
+    this.userService.getAll(1).pipe(
+      handleError({ data: [], meta: { timestamp: '', page: 1, pageSize: 10, totalItems: 0, totalPages: 0 } }),
+    ).subscribe(res => this.state.set(res.data));
+  }
+}
+```
+
+---
+
+## Commands
+
+```bash
+npx nx build u-mapsnpm    # Build
+npx nx test u-mapsnpm     # Test (52 tests)
+npm run publish:pkg        # Build + publish to npm
+```
+
+## License
+
+MIT

package/dist/angular/helpers/destroy.helper.d.ts

@@ -0,0 +1,36 @@
+import { Subject, type MonoTypeOperatorFunction } from 'rxjs';
+/**
+ * Creates an auto-cleanup Subject tied to the current injection context's DestroyRef.
+ *
+ * Use inside `inject()` context (constructor, field initializer, or runInInjectionContext).
+ *
+ * @example
+ * ```ts
+ * export class MyComponent {
+ *   private destroy$ = injectDestroy();
+ *
+ *   ngOnInit() {
+ *     someObs$.pipe(takeUntil(this.destroy$)).subscribe();
+ *   }
+ * }
+ * ```
+ */
+export declare function injectDestroy(): Subject<void>;
+/**
+ * RxJS operator that auto-unsubscribes when the injection context is destroyed.
+ *
+ * Must be called inside an injection context.
+ *
+ * @example
+ * ```ts
+ * export class MyComponent {
+ *   private untilDestroyed = takeUntilDestroyed();
+ *
+ *   ngOnInit() {
+ *     someObs$.pipe(this.untilDestroyed).subscribe();
+ *   }
+ * }
+ * ```
+ */
+export declare function takeUntilDestroyed<T>(): MonoTypeOperatorFunction<T>;
+//# sourceMappingURL=destroy.helper.d.ts.map

package/dist/angular/helpers/destroy.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destroy.helper.d.ts","sourceRoot":"","sources":["../../../src/angular/helpers/destroy.helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,MAAM,CAAC;AAG9D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAU7C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,KAAK,wBAAwB,CAAC,CAAC,CAAC,CAGnE"}

package/dist/angular/helpers/destroy.helper.js

@@ -0,0 +1,49 @@
+import { DestroyRef, inject } from '@angular/core';
+import { Subject } from 'rxjs';
+import { takeUntil } from 'rxjs/operators';
+/**
+ * Creates an auto-cleanup Subject tied to the current injection context's DestroyRef.
+ *
+ * Use inside `inject()` context (constructor, field initializer, or runInInjectionContext).
+ *
+ * @example
+ * ```ts
+ * export class MyComponent {
+ *   private destroy$ = injectDestroy();
+ *
+ *   ngOnInit() {
+ *     someObs$.pipe(takeUntil(this.destroy$)).subscribe();
+ *   }
+ * }
+ * ```
+ */
+export function injectDestroy() {
+    const destroy$ = new Subject();
+    const destroyRef = inject(DestroyRef);
+    destroyRef.onDestroy(() => {
+        destroy$.next();
+        destroy$.complete();
+    });
+    return destroy$;
+}
+/**
+ * RxJS operator that auto-unsubscribes when the injection context is destroyed.
+ *
+ * Must be called inside an injection context.
+ *
+ * @example
+ * ```ts
+ * export class MyComponent {
+ *   private untilDestroyed = takeUntilDestroyed();
+ *
+ *   ngOnInit() {
+ *     someObs$.pipe(this.untilDestroyed).subscribe();
+ *   }
+ * }
+ * ```
+ */
+export function takeUntilDestroyed() {
+    const destroy$ = injectDestroy();
+    return (source) => source.pipe(takeUntil(destroy$));
+}
+//# sourceMappingURL=destroy.helper.js.map

package/dist/angular/helpers/destroy.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"destroy.helper.js","sourceRoot":"","sources":["../../../src/angular/helpers/destroy.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,OAAO,EAAiC,MAAM,MAAM,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAQ,CAAC;IACrC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAEtC,UAAU,CAAC,SAAS,CAAC,GAAG,EAAE;QACxB,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChB,QAAQ,CAAC,QAAQ,EAAE,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/angular/helpers/rxjs.helpers.d.ts

@@ -0,0 +1,39 @@
+import { type OperatorFunction } from 'rxjs';
+/**
+ * Result type for mapResponse — discriminated union for success/error.
+ */
+export type ResponseResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: unknown;
+};
+/**
+ * Maps an Observable into a discriminated success/error result.
+ *
+ * Catches errors and wraps them instead of letting the stream die.
+ *
+ * @example
+ * ```ts
+ * this.http.get<User[]>('/users').pipe(
+ *   mapResponse(),
+ * ).subscribe(result => {
+ *   if (result.success) console.log(result.data);
+ *   else console.error(result.error);
+ * });
+ * ```
+ */
+export declare function mapResponse<T>(): OperatorFunction<T, ResponseResult<T>>;
+/**
+ * Catches errors and replaces the stream with a fallback value.
+ *
+ * @example
+ * ```ts
+ * this.http.get<User[]>('/users').pipe(
+ *   handleError([]),
+ * ).subscribe(users => { ... });
+ * ```
+ */
+export declare function handleError<T>(fallback: T): OperatorFunction<T, T>;
+//# sourceMappingURL=rxjs.helpers.d.ts.map

package/dist/angular/helpers/rxjs.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rxjs.helpers.d.ts","sourceRoot":"","sources":["../../../src/angular/helpers/rxjs.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,gBAAgB,EAAQ,MAAM,MAAM,CAAC;AAIpE;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IACxB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEvC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,CAAC,KAAK,gBAAgB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAOvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAElE"}

package/dist/angular/helpers/rxjs.helpers.js

@@ -0,0 +1,35 @@
+import { pipe } from 'rxjs';
+import { map, catchError } from 'rxjs/operators';
+import { of } from 'rxjs';
+/**
+ * Maps an Observable into a discriminated success/error result.
+ *
+ * Catches errors and wraps them instead of letting the stream die.
+ *
+ * @example
+ * ```ts
+ * this.http.get<User[]>('/users').pipe(
+ *   mapResponse(),
+ * ).subscribe(result => {
+ *   if (result.success) console.log(result.data);
+ *   else console.error(result.error);
+ * });
+ * ```
+ */
+export function mapResponse() {
+    return pipe(map((data) => ({ success: true, data })), catchError((error) => of({ success: false, error })));
+}
+/**
+ * Catches errors and replaces the stream with a fallback value.
+ *
+ * @example
+ * ```ts
+ * this.http.get<User[]>('/users').pipe(
+ *   handleError([]),
+ * ).subscribe(users => { ... });
+ * ```
+ */
+export function handleError(fallback) {
+    return catchError(() => of(fallback));
+}
+//# sourceMappingURL=rxjs.helpers.js.map

package/dist/angular/helpers/rxjs.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rxjs.helpers.js","sourceRoot":"","sources":["../../../src/angular/helpers/rxjs.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,IAAI,EAAE,MAAM,MAAM,CAAC;AACpE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAS1B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CACT,GAAG,CAAC,CAAC,IAAO,EAAqB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAC9D,UAAU,CAAC,CAAC,KAAc,EAAiC,EAAE,CAC3D,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAC9B,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAI,QAAW;IACxC,OAAO,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/angular/index.d.ts

@@ -1,4 +1,8 @@
 export { BaseService } from './services/base.service';
 export { HttpService, type RequestOptions } from './services/http.service';
 export { createLoadingState, type LoadingState } from './helpers/signal.helpers';
+export { injectDestroy, takeUntilDestroyed } from './helpers/destroy.helper';
+export { mapResponse, handleError, type ResponseResult } from './helpers/rxjs.helpers';
+export { API_URL } from './tokens/api-url.token';
+export { APP_CONFIG, type AppConfig } from './tokens/app-config.token';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/angular/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/angular/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAG3E,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGvF,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/angular/index.js

@@ -1,4 +1,11 @@
+// Services
 export { BaseService } from './services/base.service';
 export { HttpService } from './services/http.service';
+// Helpers
 export { createLoadingState } from './helpers/signal.helpers';
+export { injectDestroy, takeUntilDestroyed } from './helpers/destroy.helper';
+export { mapResponse, handleError } from './helpers/rxjs.helpers';
+// Tokens
+export { API_URL } from './tokens/api-url.token';
+export { APP_CONFIG } from './tokens/app-config.token';
 //# sourceMappingURL=index.js.map

package/dist/angular/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/angular/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAuB,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAqB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/angular/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAuB,MAAM,yBAAyB,CAAC;AAE3E,UAAU;AACV,OAAO,EAAE,kBAAkB,EAAqB,MAAM,0BAA0B,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAuB,MAAM,wBAAwB,CAAC;AAEvF,SAAS;AACT,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAkB,MAAM,2BAA2B,CAAC"}

package/dist/angular/services/http.service.d.ts

@@ -1,3 +1,4 @@
+import { HttpClient } from '@angular/common/http';
 import { Observable } from 'rxjs';
 import type { ApiResponse, PaginatedResponse } from '../types';
 export interface RequestOptions {
@@ -7,15 +8,30 @@ export interface RequestOptions {
 /**
  * Lightweight HTTP helper wrapping Angular's HttpClient.
  * Provides typed methods aligned with the shared ApiResponse envelope.
+ *
+ * Automatically prepends the API_URL token value to relative paths.
+ *
+ * @example
+ * ```ts
+ * @Injectable({ providedIn: 'root' })
+ * export class UserService extends HttpService {
+ *   getUsers() {
+ *     return this.get<User[]>('/users');
+ *   }
+ * }
+ * ```
  */
 export declare class HttpService {
-    private readonly http;
+    protected readonly http: HttpClient;
+    protected readonly apiUrl: string;
     get<T>(url: string, options?: RequestOptions): Observable<ApiResponse<T>>;
     getList<T>(url: string, options?: RequestOptions): Observable<PaginatedResponse<T>>;
     post<T>(url: string, body: unknown, options?: RequestOptions): Observable<ApiResponse<T>>;
     put<T>(url: string, body: unknown, options?: RequestOptions): Observable<ApiResponse<T>>;
     patch<T>(url: string, body: unknown, options?: RequestOptions): Observable<ApiResponse<T>>;
     delete<T>(url: string, options?: RequestOptions): Observable<ApiResponse<T>>;
+    protected resolveUrl(url: string): string;
     private buildParams;
+    private buildHeaders;
 }
 //# sourceMappingURL=http.service.d.ts.map

package/dist/angular/services/http.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.service.d.ts","sourceRoot":"","sources":["../../../src/angular/services/http.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,qBACa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;IAE3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAOzE,OAAO,CAAC,CAAC,EACP,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAOnC,IAAI,CAAC,CAAC,EACJ,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAO7B,GAAG,CAAC,CAAC,EACH,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAO7B,KAAK,CAAC,CAAC,EACL,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAO7B,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAO5E,OAAO,CAAC,WAAW;CAUpB"}
+{"version":3,"file":"http.service.d.ts","sourceRoot":"","sources":["../../../src/angular/services/http.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAA2B,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBACa,WAAW;IACtB,SAAS,CAAC,QAAQ,CAAC,IAAI,aAAsB;IAC7C,SAAS,CAAC,QAAQ,CAAC,MAAM,SAA6C;IAEtE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAOzE,OAAO,CAAC,CAAC,EACP,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAOnC,IAAI,CAAC,CAAC,EACJ,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAO7B,GAAG,CAAC,CAAC,EACH,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAO7B,KAAK,CAAC,CAAC,EACL,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAO7B,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAO5E,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAOzC,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,YAAY;CAMrB"}

package/dist/angular/services/http.service.js

@@ -5,49 +5,69 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { Injectable, inject } from '@angular/core';
-import { HttpClient, HttpParams } from '@angular/common/http';
+import { HttpClient, HttpParams, HttpHeaders } from '@angular/common/http';
+import { API_URL } from '../tokens/api-url.token';
 /**
  * Lightweight HTTP helper wrapping Angular's HttpClient.
  * Provides typed methods aligned with the shared ApiResponse envelope.
+ *
+ * Automatically prepends the API_URL token value to relative paths.
+ *
+ * @example
+ * ```ts
+ * @Injectable({ providedIn: 'root' })
+ * export class UserService extends HttpService {
+ *   getUsers() {
+ *     return this.get<User[]>('/users');
+ *   }
+ * }
+ * ```
  */
 let HttpService = class HttpService {
     http = inject(HttpClient);
+    apiUrl = inject(API_URL, { optional: true }) ?? '';
     get(url, options) {
-        return this.http.get(url, {
+        return this.http.get(this.resolveUrl(url), {
             params: this.buildParams(options?.params),
-            headers: options?.headers,
+            headers: this.buildHeaders(options?.headers),
         });
     }
     getList(url, options) {
-        return this.http.get(url, {
+        return this.http.get(this.resolveUrl(url), {
             params: this.buildParams(options?.params),
-            headers: options?.headers,
+            headers: this.buildHeaders(options?.headers),
         });
     }
     post(url, body, options) {
-        return this.http.post(url, body, {
+        return this.http.post(this.resolveUrl(url), body, {
             params: this.buildParams(options?.params),
-            headers: options?.headers,
+            headers: this.buildHeaders(options?.headers),
         });
     }
     put(url, body, options) {
-        return this.http.put(url, body, {
+        return this.http.put(this.resolveUrl(url), body, {
             params: this.buildParams(options?.params),
-            headers: options?.headers,
+            headers: this.buildHeaders(options?.headers),
         });
     }
     patch(url, body, options) {
-        return this.http.patch(url, body, {
+        return this.http.patch(this.resolveUrl(url), body, {
             params: this.buildParams(options?.params),
-            headers: options?.headers,
+            headers: this.buildHeaders(options?.headers),
         });
     }
     delete(url, options) {
-        return this.http.delete(url, {
+        return this.http.delete(this.resolveUrl(url), {
             params: this.buildParams(options?.params),
-            headers: options?.headers,
+            headers: this.buildHeaders(options?.headers),
         });
     }
+    resolveUrl(url) {
+        if (url.startsWith('http://') || url.startsWith('https://')) {
+            return url;
+        }
+        return `${this.apiUrl}${url}`;
+    }
     buildParams(params) {
         if (!params)
             return undefined;
@@ -57,6 +77,11 @@ let HttpService = class HttpService {
         }
         return httpParams;
     }
+    buildHeaders(headers) {
+        if (!headers)
+            return undefined;
+        return new HttpHeaders(headers);
+    }
 };
 HttpService = __decorate([
     Injectable({ providedIn: 'root' })

package/dist/angular/services/http.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.service.js","sourceRoot":"","sources":["../../../src/angular/services/http.service.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAS9D;;;GAGG;AAEI,IAAM,WAAW,GAAjB,MAAM,WAAW;IACL,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAE3C,GAAG,CAAI,GAAW,EAAE,OAAwB;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAiB,GAAG,EAAE;YACxC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC;YACzC,OAAO,EAAE,OAAO,EAAE,OAAO;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CACL,GAAW,EACX,OAAwB;QAExB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAuB,GAAG,EAAE;YAC9C,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC;YACzC,OAAO,EAAE,OAAO,EAAE,OAAO;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CACF,GAAW,EACX,IAAa,EACb,OAAwB;QAExB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAiB,GAAG,EAAE,IAAI,EAAE;YAC/C,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC;YACzC,OAAO,EAAE,OAAO,EAAE,OAAO;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,GAAG,CACD,GAAW,EACX,IAAa,EACb,OAAwB;QAExB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAiB,GAAG,EAAE,IAAI,EAAE;YAC9C,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC;YACzC,OAAO,EAAE,OAAO,EAAE,OAAO;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CACH,GAAW,EACX,IAAa,EACb,OAAwB;QAExB,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAiB,GAAG,EAAE,IAAI,EAAE;YAChD,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC;YACzC,OAAO,EAAE,OAAO,EAAE,OAAO;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAI,GAAW,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAiB,GAAG,EAAE;YAC3C,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC;YACzC,OAAO,EAAE,OAAO,EAAE,OAAO;SAC1B,CAAC,CAAC;IACL,CAAC;IAEO,WAAW,CACjB,MAAkD;QAElD,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,IAAI,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;QAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;CACF,CAAA;AAtEY,WAAW;IADvB,UAAU,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;GACtB,WAAW,CAsEvB"}
+{"version":3,"file":"http.service.js","sourceRoot":"","sources":["../../../src/angular/services/http.service.ts"],"names":[],"mappings":"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"}

package/dist/angular/tokens/api-url.token.d.ts

@@ -0,0 +1,16 @@
+import { InjectionToken } from '@angular/core';
+/**
+ * Token for the base API URL.
+ *
+ * Provide this at the application root to configure all services
+ * that depend on a backend endpoint.
+ *
+ * @example
+ * ```ts
+ * providers: [
+ *   { provide: API_URL, useValue: 'https://api.example.com/v1' },
+ * ]
+ * ```
+ */
+export declare const API_URL: InjectionToken<string>;
+//# sourceMappingURL=api-url.token.d.ts.map

package/dist/angular/tokens/api-url.token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-url.token.d.ts","sourceRoot":"","sources":["../../../src/angular/tokens/api-url.token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,OAAO,wBAAwC,CAAC"}

package/dist/angular/tokens/api-url.token.js

@@ -0,0 +1,16 @@
+import { InjectionToken } from '@angular/core';
+/**
+ * Token for the base API URL.
+ *
+ * Provide this at the application root to configure all services
+ * that depend on a backend endpoint.
+ *
+ * @example
+ * ```ts
+ * providers: [
+ *   { provide: API_URL, useValue: 'https://api.example.com/v1' },
+ * ]
+ * ```
+ */
+export const API_URL = new InjectionToken('API_URL');
+//# sourceMappingURL=api-url.token.js.map

package/dist/angular/tokens/api-url.token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-url.token.js","sourceRoot":"","sources":["../../../src/angular/tokens/api-url.token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,cAAc,CAAS,SAAS,CAAC,CAAC"}

package/dist/angular/tokens/app-config.token.d.ts

@@ -0,0 +1,23 @@
+import { InjectionToken } from '@angular/core';
+/**
+ * Application-wide configuration shape.
+ * Consumers extend this interface for project-specific fields.
+ */
+export interface AppConfig {
+    apiUrl: string;
+    production: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Token for application configuration.
+ *
+ * @example
+ * ```ts
+ * const config: AppConfig = { apiUrl: '/api', production: true };
+ * providers: [
+ *   { provide: APP_CONFIG, useValue: config },
+ * ]
+ * ```
+ */
+export declare const APP_CONFIG: InjectionToken<AppConfig>;
+//# sourceMappingURL=app-config.token.d.ts.map

package/dist/angular/tokens/app-config.token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.token.d.ts","sourceRoot":"","sources":["../../../src/angular/tokens/app-config.token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,2BAA8C,CAAC"}

package/dist/angular/tokens/app-config.token.js

@@ -0,0 +1,14 @@
+import { InjectionToken } from '@angular/core';
+/**
+ * Token for application configuration.
+ *
+ * @example
+ * ```ts
+ * const config: AppConfig = { apiUrl: '/api', production: true };
+ * providers: [
+ *   { provide: APP_CONFIG, useValue: config },
+ * ]
+ * ```
+ */
+export const APP_CONFIG = new InjectionToken('APP_CONFIG');
+//# sourceMappingURL=app-config.token.js.map

package/dist/angular/tokens/app-config.token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.token.js","sourceRoot":"","sources":["../../../src/angular/tokens/app-config.token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAY/C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,cAAc,CAAY,YAAY,CAAC,CAAC"}

package/dist/angular/tokens/index.d.ts

@@ -0,0 +1,3 @@
+export { API_URL } from './api-url.token';
+export { APP_CONFIG, type AppConfig } from './app-config.token';
+//# sourceMappingURL=index.d.ts.map

package/dist/angular/tokens/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/angular/tokens/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/angular/tokens/index.js

@@ -0,0 +1,3 @@
+export { API_URL } from './api-url.token';
+export { APP_CONFIG } from './app-config.token';
+//# sourceMappingURL=index.js.map

package/dist/angular/tokens/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/angular/tokens/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAkB,MAAM,oBAAoB,CAAC"}

package/dist/test-setup.d.ts

@@ -0,0 +1,3 @@
+import 'zone.js';
+import '@angular/compiler';
+//# sourceMappingURL=test-setup.d.ts.map

package/dist/test-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../src/test-setup.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,CAAC;AACjB,OAAO,mBAAmB,CAAC"}

package/dist/test-setup.js

@@ -0,0 +1,3 @@
+import 'zone.js';
+import '@angular/compiler';
+//# sourceMappingURL=test-setup.js.map

package/dist/test-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.js","sourceRoot":"","sources":["../src/test-setup.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,CAAC;AACjB,OAAO,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u-mapsnpm",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Core utilities, Angular helpers, and shared types for U-Maps platform",
   "type": "module",
   "main": "./dist/core/index.js",
@@ -25,7 +25,7 @@
   "keywords": ["u-maps", "utils", "angular", "typescript", "signals", "http"],
   "repository": {
     "type": "git",
-    "url": "https://github.com/AkbarDAfwormo/u-maps-npm"
+    "url": "https://u-gitlab.uzinfocom.uz/u-maps/frontend/u-maps-npm"
   },
   "scripts": {
     "build": "tsc -p tsconfig.lib.json",