@rivinia/http 0.2.0 → 0.3.0

package/README.md

@@ -7,7 +7,7 @@ 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.2.0**
+- Version: **0.3.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

package/fesm2022/rivinia-http.mjs

@@ -1,5 +1,5 @@
 import * as i0 from "@angular/core";
-import { InjectionToken, Service, inject, makeEnvironmentProviders } from "@angular/core";
+import { InjectionToken, Service, computed, inject, isSignal, makeEnvironmentProviders } from "@angular/core";
 import { HttpClient, HttpContext, HttpParams, httpResource, provideHttpClient } from "@angular/common/http";
 import { map } from "rxjs";
 function joinUrl(baseUrl, endpoint) {
@@ -48,8 +48,9 @@ var RiviniaHttp = class RiviniaHttp {
 	}
 	getResource(endpoint, options) {
 		const { defaultValue, parse, reportProgress, ...requestOptions } = options ?? {};
+		const source = typeof endpoint === "function" && !isSignal(endpoint) ? computed(endpoint) : endpoint;
 		const request = () => {
-			const ep = typeof endpoint === "string" ? endpoint : endpoint();
+			const ep = typeof source === "string" ? source : source();
 			if (ep === void 0) return void 0;
 			return {
 				url: this.url(ep),

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.\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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"}
+{"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, computed, inject, isSignal, 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   * The endpoint can be a static string, a signal, or a reactive function\n   * (same as `httpResource` itself) — it re-fetches on change, and\n   * `undefined` disables the request. Unwrap applies through `parse`,\n   * composed before a user `parse` if given.\n   */\n  getResource<T>(\n    endpoint: string | Signal<string | undefined> | (() => string | undefined),\n    options?: RiviniaResourceOptions<T>,\n  ): HttpResourceRef<T | undefined> {\n    const { defaultValue, parse, reportProgress, ...requestOptions } = options ?? {};\n    const source: string | Signal<string | undefined> =\n      typeof endpoint === 'function' && !isSignal(endpoint)\n        ? computed(endpoint)\n        : (endpoint as string | Signal<string | undefined>);\n    const request = () => {\n      const ep = typeof source === 'string' ? source : source();\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.2.0",
+  "version": "0.3.0",
   "description": "Headless typed HTTP client for Angular: envelope unwrapping, plain Observables and httpResource.",
   "keywords": [
     "angular",

package/types/rivinia-http.d.ts

@@ -100,10 +100,12 @@ export declare class RiviniaHttp {
   getBlob(endpoint: string, options?: RiviniaRequestOptions): Observable<Blob>;
   /**
    * Reactive GET as an `httpResource` (stable since Angular v22).
-   * Re-fetches when the endpoint signal changes; `undefined` disables.
-   * Unwrap applies through `parse`, composed before a user `parse` if given.
+   * The endpoint can be a static string, a signal, or a reactive function
+   * (same as `httpResource` itself) — it re-fetches on change, and
+   * `undefined` disables the request. Unwrap applies through `parse`,
+   * composed before a user `parse` if given.
    */
-  getResource<T>(endpoint: string | Signal<string | undefined>, options?: RiviniaResourceOptions<T>): HttpResourceRef<T | undefined>;
+  getResource<T>(endpoint: string | Signal<string | undefined> | (() => string | undefined), options?: RiviniaResourceOptions<T>): HttpResourceRef<T | undefined>;
   private url;
   private resolveUnwrap;
   private resolveKey;