@rivinia/http 0.1.0 → 0.2.0

package/README.md

@@ -3,11 +3,11 @@
 [![npm version](https://img.shields.io/npm/v/@rivinia/http.svg)](https://www.npmjs.com/package/@rivinia/http)
 [![license](https://img.shields.io/npm/l/@rivinia/http.svg)](https://www.npmjs.com/package/@rivinia/http)
 
-Headless typed HTTP client for Angular 22+. Base-URL joining, configurable
-envelope unwrapping, plain Observables **and** `httpResource` — with zero
-styling, zero backend opinions, and interceptors left to your app.
+Headless typed HTTP client for Angular 22+. Configurable envelope
+unwrapping, plain Observables **and** `httpResource` — URLs always used as
+given, zero styling, zero backend opinions, interceptors left to your app.
 
-- Version: **0.1.0**
+- Version: **0.2.0**
 - Requires: **Angular `^22.0.0`**, `rxjs` (same range Angular uses), `tslib`
 - Since Angular 21 `HttpClient` (fetch backend) is injectable with zero setup.
   Call `provideHttpClient()` / pass `httpFeatures` only when you configure
@@ -17,39 +17,47 @@ styling, zero backend opinions, and interceptors left to your app.
 
 ```bash
 npm install @rivinia/http
-ng add @rivinia/http   # interactive: asks baseUrl + envelope key, then wires app.config.ts
+ng add @rivinia/http   # interactive: asks about unwrapping + key, then wires app.config.ts
 ```
 
 ## Quick start — pick ONE backend style
 
 ```ts
 // app.config.ts — style A: nothing to configure (Angular ≥21 default)
-providers: [provideRiviniaHttp({ baseUrl: 'https://api.example.com' })];
+providers: [provideRiviniaHttp()];
 
 // style B: single call with interceptors (do NOT also call provideHttpClient)
-providers: [
-  provideRiviniaHttp({
-    baseUrl: 'https://api.example.com',
-    httpFeatures: [withInterceptors([authInterceptor])],
-  }),
-];
+providers: [provideRiviniaHttp({ httpFeatures: [withInterceptors([authInterceptor])] })];
 
 // style C: explicit backend config, like the official setup guide
-providers: [provideHttpClient(withInterceptors([authInterceptor])), provideRiviniaHttp({ baseUrl })];
+providers: [provideHttpClient(withInterceptors([authInterceptor])), provideRiviniaHttp()];
 ```
 
+## URLs: yours, always
+
+The library never joins, prefixes, or rewrites URLs. Compose them at the
+call site from wherever you want — typically your environment files
+(the BRT pattern):
+
 ```ts
-// Plain Observable (mutations, one-shot reads)
+// src/environments/environment.ts / environment.prod.ts
+export const environment = { apiUrl: 'https://api.example.com' };
+
+// feature service
+import { joinUrl } from '@rivinia/http';
+
 export class TripService {
   private api = injectRiviniaHttp();
-  list = () => this.api.get<Trip[]>('trips');
-  create = (dto: CreateTrip) => this.api.post<Trip>('trips', dto);
+  private url = (path: string) => joinUrl(environment.apiUrl, path);
+
+  list = () => this.api.get<Trip[]>(this.url('trips'));
+  create = (dto: CreateTrip) => this.api.post<Trip>(this.url('trips'), dto);
 }
 
 // Reactive resource (auto refetch, loading/error signals)
 export class TripPage {
   page = signal(1);
-  trips = this.api.getResource<Trip[]>(() => `trips?page=${this.page()}`);
+  trips = this.api.getResource<Trip[]>(() => this.url(`trips?page=${this.page()}`));
 }
 ```
 
@@ -61,15 +69,35 @@ export class TripPage {
 }
 ```
 
-## Envelope unwrapping
+## Envelope unwrapping (opt-in, default off)
+
+The library assumes nothing about your backend: responses pass through raw
+unless unwrapping is enabled. Backends that wrap payloads
+(`{ data, error, isSuccess }`) opt in globally or per call:
+
+```ts
+provideRiviniaHttp({ unwrap: true });                               // whole app, 'data' key
+provideRiviniaHttp({ unwrap: true, unwrapKey: 'result' });          // whole app, custom key
+this.api.get<Legacy>(url, { unwrap: true, unwrapKey: 'result' });   // this call only
+this.api.get<Raw>(url);                                             // raw body (default)
+```
 
-Backends that wrap payloads (`{ data, error, isSuccess }`) are unwrapped
-automatically. Control it globally, per call, or turn it off:
+NOTE: a key alone never enables unwrapping — only `unwrap: true` does,
+at either level. Different shapes per API in the same app:
 
 ```ts
-provideRiviniaHttp({ unwrapKey: 'data' });                       // global default
-this.api.get<Legacy>('legacy', { unwrapKey: 'result' });  // this call only
-this.api.get<Raw>('raw', { unwrap: false });              // raw body
+export class MixedService {
+  private api = injectRiviniaHttp();
+
+  // main backend: { data: … } (global unwrap: true applies, nothing to say)
+  trips = () => this.api.get<Trip[]>(fullUrl('trips'));
+
+  // legacy backend: { result: … } (per-call key, unwrapping already on globally)
+  legacy = () => this.api.get<Old[]>(fullUrl('old'), { unwrapKey: 'result' });
+
+  // webhook endpoint: raw body despite the enabled global (per-call kill-switch)
+  ping = () => this.api.get<string>(fullUrl('ping'), { unwrap: false });
+}
 ```
 
 `getResource` applies the same rules through `parse` (your own `parse` runs
@@ -79,7 +107,7 @@ after unwrapping — ideal for Zod/Valibot validation).
 
 | Export | Kind | Purpose |
 |---|---|---|
-| `provideRiviniaHttp(config?)` | provider | `{ baseUrl?, unwrap?=true, unwrapKey?='data', httpFeatures? }` |
+| `provideRiviniaHttp(config?)` | provider | `{ unwrap?=false, unwrapKey?='data', httpFeatures? }` |
 | `RiviniaHttp` | `@Service()` | `get/post/put/patch/delete`, `getBlob`, `getResource` |
 | `injectRiviniaHttp()` | function | shorthand for `inject(RiviniaHttp)` |
 | `joinUrl(base, endpoint)` | util | slash-safe join; absolute URLs pass through |
@@ -96,10 +124,10 @@ Standard Angular tooling — nothing custom to learn:
 
 ```ts
 TestBed.configureTestingModule({
-  providers: [provideHttpClient(), provideHttpClientTesting(), provideRiviniaHttp({ baseUrl: '/api' })],
+  providers: [provideHttpClient(), provideHttpClientTesting(), provideRiviniaHttp()],
 });
-api.get('users').subscribe();
-TestBed.inject(HttpTestingController).expectOne('/api/users').flush({ data: [] });
+api.get('https://api.test/users').subscribe();
+TestBed.inject(HttpTestingController).expectOne('https://api.test/users').flush({ data: [] });
 ```
 
 ## License

package/fesm2022/rivinia-http.mjs

@@ -84,10 +84,10 @@ var RiviniaHttp = class RiviniaHttp {
 		});
 	}
 	url(endpoint) {
-		return joinUrl(this.config?.baseUrl ?? "", endpoint);
+		return endpoint;
 	}
 	resolveUnwrap(options) {
-		return options?.unwrap ?? this.config?.unwrap ?? true;
+		return options?.unwrap ?? this.config?.unwrap ?? false;
 	}
 	resolveKey(options) {
 		return options?.unwrapKey ?? this.config?.unwrapKey ?? "data";

package/fesm2022/rivinia-http.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"rivinia-http.mjs","names":[],"sources":["../../../projects/http/src/lib/http-utils.ts","../../../projects/http/src/lib/http-config.ts","../../../projects/http/src/lib/rivinia-http.ts","../../../projects/http/src/lib/provide-http.ts"],"sourcesContent":["/**\n * Joins a base URL and an endpoint without producing double slashes.\n * Absolute `http(s)` endpoints pass through untouched.\n */\nexport function joinUrl(baseUrl: string, endpoint: string): string {\n  if (/^https?:\\/\\//i.test(endpoint)) {\n    return endpoint;\n  }\n  const base = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n  const path = endpoint.startsWith('/') ? endpoint.slice(1) : endpoint;\n  return path ? `${base}/${path}` : base;\n}\n\n/**\n * Extracts `body[key]` when the backend wraps payloads in an envelope\n * (e.g. `{ data, error, isSuccess }`); passes anything else through\n * unchanged. Recursive, so nested envelopes collapse.\n */\nexport function unwrapAs<T>(body: unknown, key: string): T {\n  if (isObjectRecord(body) && hasOwn(body, key)) {\n    return unwrapAs<T>(body[key], key);\n  }\n  return body as T;\n}\n\nfunction isObjectRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction hasOwn(obj: Record<string, unknown>, key: string): boolean {\n  return Object.prototype.hasOwnProperty.call(obj, key);\n}\n","import type { HttpFeature, HttpFeatureKind } from '@angular/common/http';\nimport { InjectionToken } from '@angular/core';\n\n/**\n * Global configuration for `@rivinia/http`.\n *\n * Every field is optional and can be overridden per request, except\n * `baseUrl` which only exists globally (absolute URLs always pass through).\n */\nexport interface RiviniaHttpConfig {\n  /** Base URL joined with every relative endpoint. No trailing slash needed. */\n  baseUrl?: string;\n  /**\n   * Unwrap `{ [unwrapKey]: payload }` envelopes by default.\n   * @default true (BRT convention: backends wrap payloads in `{ data }`).\n   */\n  unwrap?: boolean;\n  /**\n   * Envelope key unwrapped when `unwrap` is enabled.\n   * @default 'data'\n   */\n  unwrapKey?: string;\n  /**\n   * Optional `HttpClient` features (`withInterceptors(...)`, `withXhr()`, …),\n   * applied via a single internal `provideHttpClient(...httpFeatures)` call.\n   *\n   * Use this INSTEAD of calling `provideHttpClient()` yourself — calling both\n   * registers the built-in XSRF interceptor twice (verified against Angular\n   * 22.2.2 source: `xsrfInterceptorFn` is a multi-provider with no cross-call\n   * dedup). Omit it entirely on Angular ≥21 when you need no features:\n   * `HttpClient` (fetch backend) is injectable by default.\n   */\n  httpFeatures?: HttpFeature<HttpFeatureKind>[];\n}\n\n/**\n * Internal configuration token. Consumers must use `provideRiviniaHttp()`.\n * @internal\n */\nexport const RIVINIA_HTTP_CONFIG = new InjectionToken<RiviniaHttpConfig>(\n  'RIVINIA_HTTP_CONFIG',\n);\n\nexport const DEFAULT_UNWRAP = true;\nexport const DEFAULT_UNWRAP_KEY = 'data';\n","import {\n  HttpClient,\n  HttpContext,\n  HttpParams,\n  httpResource,\n  type HttpResourceRef,\n} from '@angular/common/http';\nimport { Service, inject, type Signal } from '@angular/core';\nimport { map, type Observable } from 'rxjs';\nimport {\n  DEFAULT_UNWRAP,\n  DEFAULT_UNWRAP_KEY,\n  RIVINIA_HTTP_CONFIG,\n  type RiviniaHttpConfig,\n} from './http-config';\nimport {\n  type QueryParamsInput,\n  type RiviniaDeleteOptions,\n  type RiviniaRequestOptions,\n} from './http-options';\nimport { joinUrl, unwrapAs } from './http-utils';\n\n/** Options for `getResource` in addition to per-request options. */\nexport interface RiviniaResourceOptions<T> extends RiviniaRequestOptions {\n  /** Value while idle/loading. Defaults to `undefined`. */\n  defaultValue?: T;\n  /**\n   * Runs AFTER envelope unwrapping: `raw -> unwrap -> parse`.\n   * Use for runtime validation (e.g. Zod) or shaping.\n   */\n  parse?: (value: unknown) => T;\n  /**\n   * Forwarded to the `httpResource` request object only (enables the\n   * resource `progress` signal for downloads). Has no effect on the\n   * plain Observable methods — use `HttpClient` events there directly.\n   */\n  reportProgress?: boolean;\n}\n\n/**\n * Headless typed HTTP client.\n *\n * Thin over `HttpClient` (so app interceptors, `HttpContext` escape hatches\n * and `provideHttpClient()` testing all keep working). Owns no backend:\n * the app provides `HttpClient`, this library only adds base-URL joining\n * plus configurable envelope unwrapping.\n *\n * Unwrap resolution per call: `options.unwrap ?? config.unwrap ?? true`,\n * key: `options.unwrapKey ?? config.unwrapKey ?? 'data'`.\n */\n@Service()\nexport class RiviniaHttp {\n  private readonly http = inject(HttpClient);\n  private readonly config = inject<RiviniaHttpConfig>(RIVINIA_HTTP_CONFIG, {\n    optional: true,\n  });\n\n  get<T>(endpoint: string, options?: RiviniaRequestOptions): Observable<T> {\n    return this.http\n      .get<unknown>(this.url(endpoint), this.httpOptions(options))\n      .pipe(map((body) => this.applyUnwrap<T>(body, options)));\n  }\n\n  post<T>(endpoint: string, body?: unknown, options?: RiviniaRequestOptions): Observable<T> {\n    return this.http\n      .post<unknown>(this.url(endpoint), body, this.httpOptions(options))\n      .pipe(map((res) => this.applyUnwrap<T>(res, options)));\n  }\n\n  put<T>(endpoint: string, body?: unknown, options?: RiviniaRequestOptions): Observable<T> {\n    return this.http\n      .put<unknown>(this.url(endpoint), body, this.httpOptions(options))\n      .pipe(map((res) => this.applyUnwrap<T>(res, options)));\n  }\n\n  patch<T>(endpoint: string, body?: unknown, options?: RiviniaRequestOptions): Observable<T> {\n    return this.http\n      .patch<unknown>(this.url(endpoint), body, this.httpOptions(options))\n      .pipe(map((res) => this.applyUnwrap<T>(res, options)));\n  }\n\n  delete<T>(endpoint: string, options?: RiviniaDeleteOptions): Observable<T> {\n    return this.http\n      .delete<unknown>(this.url(endpoint), {\n        ...this.httpOptions(options),\n        body: options?.body,\n      })\n      .pipe(map((res) => this.applyUnwrap<T>(res, options)));\n  }\n\n  /** Binary download. Never unwrapped — envelopes don't apply to blobs. */\n  getBlob(endpoint: string, options?: RiviniaRequestOptions): Observable<Blob> {\n    return this.http.get(this.url(endpoint), {\n      ...this.httpOptions(options),\n      responseType: 'blob',\n    });\n  }\n\n  /**\n   * Reactive GET as an `httpResource` (stable since Angular v22).\n   * Re-fetches when the endpoint signal changes; `undefined` disables.\n   * Unwrap applies through `parse`, composed before a user `parse` if given.\n   */\n  getResource<T>(\n    endpoint: string | Signal<string | undefined>,\n    options?: RiviniaResourceOptions<T>,\n  ): HttpResourceRef<T | undefined> {\n    const { defaultValue, parse, reportProgress, ...requestOptions } = options ?? {};\n    const request = () => {\n      const ep = typeof endpoint === 'string' ? endpoint : endpoint();\n      if (ep === undefined) return undefined;\n      return {\n        url: this.url(ep),\n        params: this.toParams(requestOptions.params),\n        headers: requestOptions.headers,\n        context: requestOptions.context,\n        withCredentials: requestOptions.withCredentials,\n        ...(reportProgress !== undefined ? { reportProgress } : {}),\n      };\n    };\n    const unwrapKey = this.resolveKey(requestOptions);\n    const unwrapEnabled = this.resolveUnwrap(requestOptions);\n    const base = { defaultValue: defaultValue as T | undefined };\n    if (unwrapEnabled) {\n      const applyParse = (raw: unknown): T =>\n        parse ? parse(unwrapAs<T>(raw, unwrapKey)) : unwrapAs<T>(raw, unwrapKey);\n      return defaultValue === undefined\n        ? httpResource<T>(request, { ...base, parse: applyParse })\n        : httpResource<T>(request, {\n            ...base,\n            defaultValue: defaultValue as T,\n            parse: applyParse,\n          });\n    }\n    return defaultValue === undefined\n      ? httpResource<T>(request, { ...base, ...(parse ? { parse } : {}) })\n      : httpResource<T>(request, {\n          ...base,\n          defaultValue: defaultValue as T,\n          ...(parse ? { parse } : {}),\n        });\n  }\n\n  private url(endpoint: string): string {\n    return joinUrl(this.config?.baseUrl ?? '', endpoint);\n  }\n\n  private resolveUnwrap(options?: RiviniaRequestOptions): boolean {\n    return options?.unwrap ?? this.config?.unwrap ?? DEFAULT_UNWRAP;\n  }\n\n  private resolveKey(options?: RiviniaRequestOptions): string {\n    return options?.unwrapKey ?? this.config?.unwrapKey ?? DEFAULT_UNWRAP_KEY;\n  }\n\n  private applyUnwrap<T>(body: unknown, options?: RiviniaRequestOptions): T {\n    if (!this.resolveUnwrap(options)) return body as T;\n    return unwrapAs<T>(body, this.resolveKey(options));\n  }\n\n  private httpOptions(options?: RiviniaRequestOptions) {\n    return {\n      params: this.toParams(options?.params),\n      headers: options?.headers,\n      context: options?.context ?? new HttpContext(),\n      withCredentials: options?.withCredentials,\n    };\n  }\n\n  private toParams(input?: QueryParamsInput): HttpParams | undefined {\n    if (!input) return undefined;\n    if (input instanceof HttpParams) return input;\n    let params = new HttpParams();\n    for (const [key, value] of Object.entries(input)) {\n      if (value !== undefined && value !== null) {\n        params = params.set(key, String(value));\n      }\n    }\n    return params;\n  }\n}\n","import { EnvironmentProviders, inject, makeEnvironmentProviders } from '@angular/core';\nimport { provideHttpClient } from '@angular/common/http';\nimport { RIVINIA_HTTP_CONFIG, type RiviniaHttpConfig } from './http-config';\nimport { RiviniaHttp } from './rivinia-http';\n\n/**\n * Configures `@rivinia/http`.\n *\n * Three styles (pick ONE backend path):\n * - `provideRiviniaHttp()` alone — Angular ≥21 already injects `HttpClient` (fetch).\n * - `provideRiviniaHttp({ httpFeatures: [withInterceptors([...])] })` — single call\n *   that also configures the backend. Do NOT additionally call\n *   `provideHttpClient()` (double registration duplicates the XSRF interceptor).\n * - `provideHttpClient(...)` + `provideRiviniaHttp()` separately — equivalent, keeps\n *   backend config visibly in app code (this is what `ng add` generates).\n *\n * @example\n * ```ts\n * provideRiviniaHttp({ baseUrl: 'https://api.example.com', unwrapKey: 'data' })\n * ```\n */\nexport function provideRiviniaHttp(config: RiviniaHttpConfig = {}): EnvironmentProviders {\n  const { httpFeatures, ...rest } = config;\n  return makeEnvironmentProviders([\n    ...(httpFeatures ? [provideHttpClient(...httpFeatures)] : []),\n    { provide: RIVINIA_HTTP_CONFIG, useValue: rest },\n  ]);\n}\n\n/** Shorthand for `inject(RiviniaHttp)`. */\nexport function injectRiviniaHttp(): RiviniaHttp {\n  return inject(RiviniaHttp);\n}\n"],"mappings":"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"}
+{"version":3,"file":"rivinia-http.mjs","names":[],"sources":["../../../projects/http/src/lib/http-utils.ts","../../../projects/http/src/lib/http-config.ts","../../../projects/http/src/lib/rivinia-http.ts","../../../projects/http/src/lib/provide-http.ts"],"sourcesContent":["/**\n * Joins a base URL and an endpoint without producing double slashes.\n * Absolute `http(s)` endpoints pass through untouched.\n */\nexport function joinUrl(baseUrl: string, endpoint: string): string {\n  if (/^https?:\\/\\//i.test(endpoint)) {\n    return endpoint;\n  }\n  const base = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n  const path = endpoint.startsWith('/') ? endpoint.slice(1) : endpoint;\n  return path ? `${base}/${path}` : base;\n}\n\n/**\n * Extracts `body[key]` when the backend wraps payloads in an envelope\n * (e.g. `{ data, error, isSuccess }`); passes anything else through\n * unchanged. Recursive, so nested envelopes collapse.\n */\nexport function unwrapAs<T>(body: unknown, key: string): T {\n  if (isObjectRecord(body) && hasOwn(body, key)) {\n    return unwrapAs<T>(body[key], key);\n  }\n  return body as T;\n}\n\nfunction isObjectRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction hasOwn(obj: Record<string, unknown>, key: string): boolean {\n  return Object.prototype.hasOwnProperty.call(obj, key);\n}\n","import type { HttpFeature, HttpFeatureKind } from '@angular/common/http';\nimport { InjectionToken } from '@angular/core';\n\n/**\n * Global configuration for `@rivinia/http`.\n *\n * Every field is optional and can be overridden per request.\n * URLs are ALWAYS used as given — the library never joins, prefixes, or\n * rewrites them. Build them at the call site from wherever you want\n * (`environment.apiUrl`, a constant, a signal …) with the exported `joinUrl`.\n */\nexport interface RiviniaHttpConfig {\n  /**\n   * Unwrap `{ [unwrapKey]: payload }` envelopes by default.\n   * @default false — the library assumes nothing about your backend;\n   * opt in globally here or per call with `{ unwrap: true }`.\n   */\n  unwrap?: boolean;\n  /**\n   * Envelope key unwrapped when `unwrap` is enabled.\n   * @default 'data'\n   */\n  unwrapKey?: string;\n  /**\n   * Optional `HttpClient` features (`withInterceptors(...)`, `withXhr()`, …),\n   * applied via a single internal `provideHttpClient(...httpFeatures)` call.\n   *\n   * Use this INSTEAD of calling `provideHttpClient()` yourself — calling both\n   * registers the built-in XSRF interceptor twice (verified against Angular\n   * 22.2.2 source: `xsrfInterceptorFn` is a multi-provider with no cross-call\n   * dedup). Omit it entirely on Angular ≥21 when you need no features:\n   * `HttpClient` (fetch backend) is injectable by default.\n   */\n  httpFeatures?: HttpFeature<HttpFeatureKind>[];\n}\n\n/**\n * Internal configuration token. Consumers must use `provideRiviniaHttp()`.\n * @internal\n */\nexport const RIVINIA_HTTP_CONFIG = new InjectionToken<RiviniaHttpConfig>(\n  'RIVINIA_HTTP_CONFIG',\n);\n\nexport const DEFAULT_UNWRAP = false;\nexport const DEFAULT_UNWRAP_KEY = 'data';\n","import {\n  HttpClient,\n  HttpContext,\n  HttpParams,\n  httpResource,\n  type HttpResourceRef,\n} from '@angular/common/http';\nimport { Service, inject, type Signal } from '@angular/core';\nimport { map, type Observable } from 'rxjs';\nimport {\n  DEFAULT_UNWRAP,\n  DEFAULT_UNWRAP_KEY,\n  RIVINIA_HTTP_CONFIG,\n  type RiviniaHttpConfig,\n} from './http-config';\nimport {\n  type QueryParamsInput,\n  type RiviniaDeleteOptions,\n  type RiviniaRequestOptions,\n} from './http-options';\nimport { unwrapAs } from './http-utils';\n\n/** Options for `getResource` in addition to per-request options. */\nexport interface RiviniaResourceOptions<T> extends RiviniaRequestOptions {\n  /** Value while idle/loading. Defaults to `undefined`. */\n  defaultValue?: T;\n  /**\n   * Runs AFTER envelope unwrapping: `raw -> unwrap -> parse`.\n   * Use for runtime validation (e.g. Zod) or shaping.\n   */\n  parse?: (value: unknown) => T;\n  /**\n   * Forwarded to the `httpResource` request object only (enables the\n   * resource `progress` signal for downloads). Has no effect on the\n   * plain Observable methods — use `HttpClient` events there directly.\n   */\n  reportProgress?: boolean;\n}\n\n/**\n * Headless typed HTTP client.\n *\n * Thin over `HttpClient` (so app interceptors, `HttpContext` escape hatches\n * and `provideHttpClient()` testing all keep working). Owns no backend:\n * the app provides `HttpClient`, this library only adds base-URL joining\n * plus configurable envelope unwrapping.\n *\n * Unwrap resolution per call: `options.unwrap ?? config.unwrap ?? true`,\n * key: `options.unwrapKey ?? config.unwrapKey ?? 'data'`.\n */\n@Service()\nexport class RiviniaHttp {\n  private readonly http = inject(HttpClient);\n  private readonly config = inject<RiviniaHttpConfig>(RIVINIA_HTTP_CONFIG, {\n    optional: true,\n  });\n\n  get<T>(endpoint: string, options?: RiviniaRequestOptions): Observable<T> {\n    return this.http\n      .get<unknown>(this.url(endpoint), this.httpOptions(options))\n      .pipe(map((body) => this.applyUnwrap<T>(body, options)));\n  }\n\n  post<T>(endpoint: string, body?: unknown, options?: RiviniaRequestOptions): Observable<T> {\n    return this.http\n      .post<unknown>(this.url(endpoint), body, this.httpOptions(options))\n      .pipe(map((res) => this.applyUnwrap<T>(res, options)));\n  }\n\n  put<T>(endpoint: string, body?: unknown, options?: RiviniaRequestOptions): Observable<T> {\n    return this.http\n      .put<unknown>(this.url(endpoint), body, this.httpOptions(options))\n      .pipe(map((res) => this.applyUnwrap<T>(res, options)));\n  }\n\n  patch<T>(endpoint: string, body?: unknown, options?: RiviniaRequestOptions): Observable<T> {\n    return this.http\n      .patch<unknown>(this.url(endpoint), body, this.httpOptions(options))\n      .pipe(map((res) => this.applyUnwrap<T>(res, options)));\n  }\n\n  delete<T>(endpoint: string, options?: RiviniaDeleteOptions): Observable<T> {\n    return this.http\n      .delete<unknown>(this.url(endpoint), {\n        ...this.httpOptions(options),\n        body: options?.body,\n      })\n      .pipe(map((res) => this.applyUnwrap<T>(res, options)));\n  }\n\n  /** Binary download. Never unwrapped — envelopes don't apply to blobs. */\n  getBlob(endpoint: string, options?: RiviniaRequestOptions): Observable<Blob> {\n    return this.http.get(this.url(endpoint), {\n      ...this.httpOptions(options),\n      responseType: 'blob',\n    });\n  }\n\n  /**\n   * Reactive GET as an `httpResource` (stable since Angular v22).\n   * Re-fetches when the endpoint signal changes; `undefined` disables.\n   * Unwrap applies through `parse`, composed before a user `parse` if given.\n   */\n  getResource<T>(\n    endpoint: string | Signal<string | undefined>,\n    options?: RiviniaResourceOptions<T>,\n  ): HttpResourceRef<T | undefined> {\n    const { defaultValue, parse, reportProgress, ...requestOptions } = options ?? {};\n    const request = () => {\n      const ep = typeof endpoint === 'string' ? endpoint : endpoint();\n      if (ep === undefined) return undefined;\n      return {\n        url: this.url(ep),\n        params: this.toParams(requestOptions.params),\n        headers: requestOptions.headers,\n        context: requestOptions.context,\n        withCredentials: requestOptions.withCredentials,\n        ...(reportProgress !== undefined ? { reportProgress } : {}),\n      };\n    };\n    const unwrapKey = this.resolveKey(requestOptions);\n    const unwrapEnabled = this.resolveUnwrap(requestOptions);\n    const base = { defaultValue: defaultValue as T | undefined };\n    if (unwrapEnabled) {\n      const applyParse = (raw: unknown): T =>\n        parse ? parse(unwrapAs<T>(raw, unwrapKey)) : unwrapAs<T>(raw, unwrapKey);\n      return defaultValue === undefined\n        ? httpResource<T>(request, { ...base, parse: applyParse })\n        : httpResource<T>(request, {\n            ...base,\n            defaultValue: defaultValue as T,\n            parse: applyParse,\n          });\n    }\n    return defaultValue === undefined\n      ? httpResource<T>(request, { ...base, ...(parse ? { parse } : {}) })\n      : httpResource<T>(request, {\n          ...base,\n          defaultValue: defaultValue as T,\n          ...(parse ? { parse } : {}),\n        });\n  }\n\n  private url(endpoint: string): string {\n    // Deliberate passthrough: the caller owns the URL (environment, constant,\n    // signal …). Use the exported `joinUrl` at the call site when composing.\n    return endpoint;\n  }\n\n  private resolveUnwrap(options?: RiviniaRequestOptions): boolean {\n    return options?.unwrap ?? this.config?.unwrap ?? DEFAULT_UNWRAP;\n  }\n\n  private resolveKey(options?: RiviniaRequestOptions): string {\n    return options?.unwrapKey ?? this.config?.unwrapKey ?? DEFAULT_UNWRAP_KEY;\n  }\n\n  private applyUnwrap<T>(body: unknown, options?: RiviniaRequestOptions): T {\n    if (!this.resolveUnwrap(options)) return body as T;\n    return unwrapAs<T>(body, this.resolveKey(options));\n  }\n\n  private httpOptions(options?: RiviniaRequestOptions) {\n    return {\n      params: this.toParams(options?.params),\n      headers: options?.headers,\n      context: options?.context ?? new HttpContext(),\n      withCredentials: options?.withCredentials,\n    };\n  }\n\n  private toParams(input?: QueryParamsInput): HttpParams | undefined {\n    if (!input) return undefined;\n    if (input instanceof HttpParams) return input;\n    let params = new HttpParams();\n    for (const [key, value] of Object.entries(input)) {\n      if (value !== undefined && value !== null) {\n        params = params.set(key, String(value));\n      }\n    }\n    return params;\n  }\n}\n","import { EnvironmentProviders, inject, makeEnvironmentProviders } from '@angular/core';\nimport { provideHttpClient } from '@angular/common/http';\nimport { RIVINIA_HTTP_CONFIG, type RiviniaHttpConfig } from './http-config';\nimport { RiviniaHttp } from './rivinia-http';\n\n/**\n * Configures `@rivinia/http`.\n *\n * URLs are always used as given — build them at the call site from wherever\n * you want (see the exported `joinUrl` + your `environment.apiUrl`).\n *\n * Three backend styles (pick ONE):\n * - `provideRiviniaHttp()` alone — Angular ≥21 already injects `HttpClient` (fetch).\n * - `provideRiviniaHttp({ httpFeatures: [withInterceptors([...])] })` — single\n *   call that also configures the backend. Do NOT additionally call\n *   `provideHttpClient()` (double registration duplicates the XSRF interceptor).\n * - `provideHttpClient(...)` + `provideRiviniaHttp()` separately — equivalent,\n *   keeps backend config visibly in app code (this is what `ng add` generates).\n *\n * @example\n * ```ts\n * provideRiviniaHttp({ unwrapKey: 'data' })\n * ```\n */\nexport function provideRiviniaHttp(config: RiviniaHttpConfig = {}): EnvironmentProviders {\n  const { httpFeatures, ...rest } = config;\n  return makeEnvironmentProviders([\n    ...(httpFeatures ? [provideHttpClient(...httpFeatures)] : []),\n    { provide: RIVINIA_HTTP_CONFIG, useValue: rest },\n  ]);\n}\n\n/** Shorthand for `inject(RiviniaHttp)`. */\nexport function injectRiviniaHttp(): RiviniaHttp {\n  return inject(RiviniaHttp);\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rivinia/http",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Headless typed HTTP client for Angular: envelope unwrapping, plain Observables and httpResource.",
   "keywords": [
     "angular",

package/schematics/ng-add/index.cjs

@@ -10,7 +10,7 @@ const PROVIDE_HTTP_IMPORT = `import { provideRiviniaHttp } from '@rivinia/http';
  * - Never overwrites user files; only inserts two imports + two providers.
  * - Idempotent: safe to run twice (existing entries are detected and skipped).
  * - Never provides the backend beyond `provideHttpClient()`; interceptors,
- *   base URL policy and unwrap options stay app-owned (see `baseUrl` option).
+ *   URLs and unwrap options stay app-owned (see schema options).
  */
 function ngAdd(options) {
     return (tree, context) => {
@@ -32,23 +32,24 @@ function ngAdd(options) {
         if (!content) {
             throw new schematics_1.SchematicsException(`[rivinia/http] ${configPath} is empty.`);
         }
-        // Deterministic mapping, no ambiguity:
-        // - unwrap === false  → { ..., unwrap: false } (key ignored, said plainly in logs)
-        // - unwrap !== false  → key emitted only when custom (anything but ''/'data',
-        //   which both mean the library default — emitting them would be noise).
+        // Deterministic mapping, no ambiguity (library default: disabled):
+        // - unwrap !== true   → emit nothing about unwrapping (raw passthrough).
+        //   A custom key given alongside is ignored, said plainly in logs.
+        // - unwrap === true   → emit `unwrap: true`, plus the key only when custom
+        //   (anything but ''/'data', which both mean the library default key).
+        // URLs are never touched: the caller owns them (environment, joinUrl, …).
         const parts = [];
-        if (options.baseUrl && options.baseUrl.length > 0) {
-            parts.push(`baseUrl: '${options.baseUrl}'`);
-        }
-        const unwrapEnabled = options.unwrap !== false;
+        const unwrapEnabled = options.unwrap === true;
         if (!unwrapEnabled) {
-            parts.push('unwrap: false');
             if (options.unwrapKey && options.unwrapKey !== 'data') {
-                context.logger.info(`[rivinia/http] unwrapping disabled — custom unwrapKey '${options.unwrapKey}' ignored.`);
+                context.logger.info(`[rivinia/http] unwrapping not enabled — custom unwrapKey '${options.unwrapKey}' ignored.`);
             }
         }
-        else if (options.unwrapKey && options.unwrapKey.length > 0 && options.unwrapKey !== 'data') {
-            parts.push(`unwrapKey: '${options.unwrapKey}'`);
+        else {
+            parts.push('unwrap: true');
+            if (options.unwrapKey && options.unwrapKey.length > 0 && options.unwrapKey !== 'data') {
+                parts.push(`unwrapKey: '${options.unwrapKey}'`);
+            }
         }
         const provideArg = parts.length > 0 ? `{ ${parts.join(', ')} }` : '';
         let changed = false;

package/schematics/ng-add/schema.json

@@ -4,17 +4,9 @@
   "title": "Rivinia HTTP ng-add options",
   "type": "object",
   "properties": {
-    "baseUrl": {
-      "type": "string",
-      "description": "Base URL passed as provideRiviniaHttp({ baseUrl }). Omit to configure later.",
-      "x-prompt": {
-        "message": "API base URL for this project (Enter to skip)?",
-        "type": "input"
-      }
-    },
     "project": {
       "type": "string",
-      "description": "Angular project to modify. Defaults to the workspace default project.",
+      "description": "Angular CLI project name — only for multi-app workspaces. Defaults to the workspace default project. Unrelated to unwrap scope.",
       "default": ""
     },
     "unwrapKey": {

package/types/rivinia-http.d.ts

@@ -5,15 +5,16 @@ import { Observable } from "rxjs";
 /**
  * Global configuration for `@rivinia/http`.
  *
- * Every field is optional and can be overridden per request, except
- * `baseUrl` which only exists globally (absolute URLs always pass through).
+ * Every field is optional and can be overridden per request.
+ * URLs are ALWAYS used as given — the library never joins, prefixes, or
+ * rewrites them. Build them at the call site from wherever you want
+ * (`environment.apiUrl`, a constant, a signal …) with the exported `joinUrl`.
  */
 interface RiviniaHttpConfig {
-  /** Base URL joined with every relative endpoint. No trailing slash needed. */
-  baseUrl?: string;
   /**
    * Unwrap `{ [unwrapKey]: payload }` envelopes by default.
-   * @default true (BRT convention: backends wrap payloads in `{ data }`).
+   * @default false — the library assumes nothing about your backend;
+   * opt in globally here or per call with `{ unwrap: true }`.
    */
   unwrap?: boolean;
   /**
@@ -38,7 +39,7 @@ interface RiviniaHttpConfig {
  * @internal
  */
 declare const RIVINIA_HTTP_CONFIG: InjectionToken<RiviniaHttpConfig>;
-declare const DEFAULT_UNWRAP = true;
+declare const DEFAULT_UNWRAP = false;
 declare const DEFAULT_UNWRAP_KEY = "data";
 /** Shorthand for building query strings; `null`/`undefined` values are dropped. */
 type QueryParamsInput = HttpParams | Record<string, string | number | boolean | undefined | null>;
@@ -126,17 +127,20 @@ export declare function unwrapAs<T>(body: unknown, key: string): T;
 /**
  * Configures `@rivinia/http`.
  *
- * Three styles (pick ONE backend path):
+ * URLs are always used as given — build them at the call site from wherever
+ * you want (see the exported `joinUrl` + your `environment.apiUrl`).
+ *
+ * Three backend styles (pick ONE):
  * - `provideRiviniaHttp()` alone — Angular ≥21 already injects `HttpClient` (fetch).
- * - `provideRiviniaHttp({ httpFeatures: [withInterceptors([...])] })` — single call
- *   that also configures the backend. Do NOT additionally call
+ * - `provideRiviniaHttp({ httpFeatures: [withInterceptors([...])] })` — single
+ *   call that also configures the backend. Do NOT additionally call
  *   `provideHttpClient()` (double registration duplicates the XSRF interceptor).
- * - `provideHttpClient(...)` + `provideRiviniaHttp()` separately — equivalent, keeps
- *   backend config visibly in app code (this is what `ng add` generates).
+ * - `provideHttpClient(...)` + `provideRiviniaHttp()` separately — equivalent,
+ *   keeps backend config visibly in app code (this is what `ng add` generates).
  *
  * @example
  * ```ts
- * provideRiviniaHttp({ baseUrl: 'https://api.example.com', unwrapKey: 'data' })
+ * provideRiviniaHttp({ unwrapKey: 'data' })
  * ```
  */
 export declare function provideRiviniaHttp(config?: RiviniaHttpConfig): EnvironmentProviders;