@telperion/ng-pack 1.4.2 → 1.6.0

package/README.md

@@ -126,11 +126,12 @@ Angular service for Server-Sent Events (SSE) with RxJS Observables and HttpClien
 
 ```typescript
 import { ApplicationConfig } from '@angular/core';
-import { provideSseClient, withSseInterceptors } from '@telperion/ng-pack/sse-client';
+import { provideSseClient, withSseInterceptors, withBaseInit } from '@telperion/ng-pack/sse-client';
 
 export const appConfig: ApplicationConfig = {
   providers: [
     provideSseClient(
+      withBaseInit({ withCredentials: true }),
       withSseInterceptors(loggingInterceptor, authInterceptor)
     ),
   ]
@@ -199,7 +200,8 @@ Angular utility functions and plugins for enhanced development experience.
 - 🎯 Event modifier syntax for templates (`.pd`, `.sp`)
 - 🔗 Directive-as-service provider utility
 - 🌐 Promise-based HTTP client with tuple error handling
-- 📦 Tree-shakeable and type-safe
+- � Unified `toSignal` — convert values, Promises, or Observables to Signals
+- �📦 Tree-shakeable and type-safe
 - ⚡ Zero dependencies
 
 #### Quick Start

package/fesm2022/telperion-ng-pack-sse-client.mjs

@@ -10,6 +10,37 @@ var SseFeatureKind;
     SseFeatureKind[SseFeatureKind["InterceptorFunction"] = 0] = "InterceptorFunction";
 })(SseFeatureKind || (SseFeatureKind = {}));
 
+/**
+ * Configures default EventSource initialization options for the SSE client.
+ * Merges the provided options into every SSE request's `init` via an interceptor.
+ *
+ * @param init - Partial EventSource initialization options to apply as defaults
+ * @returns Array of SSE features to be used with `provideSseClient()`
+ *
+ * @example
+ * ```typescript
+ * provideSseClient(
+ *   withBaseInit({ withCredentials: true })
+ * )
+ * ```
+ */
+function withBaseInit(init) {
+    return [
+        {
+            kind: SseFeatureKind.InterceptorFunction,
+            interceptor(req, next) {
+                return next({
+                    ...req,
+                    init: {
+                        ...req.init,
+                        ...init
+                    }
+                });
+            }
+        }
+    ];
+}
+
 /**
  * Configures functional interceptors for the SSE client.
  * Interceptors are executed in the order they are provided.
@@ -148,5 +179,5 @@ function provideSseClient(...features) {
  * Generated bundle index. Do not edit.
  */
 
-export { SSE_INTERCEPTORS, SseClient, SseFeatureKind, provideSseClient, withSseInterceptors };
+export { SSE_INTERCEPTORS, SseClient, SseFeatureKind, provideSseClient, withBaseInit, withSseInterceptors };
 //# sourceMappingURL=telperion-ng-pack-sse-client.mjs.map

package/fesm2022/telperion-ng-pack-sse-client.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"telperion-ng-pack-sse-client.mjs","sources":["../../sse-client/src/features/feature.ts","../../sse-client/src/features/with-interceptors.ts","../../sse-client/src/interceptor.ts","../../sse-client/src/client.ts","../../sse-client/src/provider.ts","../../sse-client/src/telperion-ng-pack-sse-client.ts"],"sourcesContent":["/**\r\n * Enum identifying different types of SSE features.\r\n */\r\nexport enum SseFeatureKind {\r\n  InterceptorFunction\r\n}\r\n\r\n/**\r\n * Base interface for SSE feature configurations.\r\n */\r\nexport interface SseFeature {\r\n  kind: SseFeatureKind;\r\n}\r\n","import { SseInterceptorFn } from \"../interceptor\";\r\nimport { SseFeature, SseFeatureKind } from \"./feature\";\r\n\r\n/**\r\n * Feature interface for functional interceptors.\r\n * @internal\r\n */\r\nexport interface SseInterceptorFunctionFeature extends SseFeature {\r\n  kind: SseFeatureKind.InterceptorFunction;\r\n  interceptor: SseInterceptorFn<unknown>;\r\n}\r\n\r\n/**\r\n * Configures functional interceptors for the SSE client.\r\n * Interceptors are executed in the order they are provided.\r\n *\r\n * @param interceptors - One or more functional interceptor functions\r\n * @returns Array of SSE features to be used with provideSseClient()\r\n *\r\n * @example\r\n * ```typescript\r\n * const loggingInterceptor: SseInterceptorFn<any> = (req, next) => {\r\n *   console.log('Connecting to:', req.url);\r\n *   return next(req);\r\n * };\r\n *\r\n * provideSseClient(\r\n *   withSseInterceptors(loggingInterceptor)\r\n * )\r\n * ```\r\n */\r\nexport function withSseInterceptors<T = unknown>(...interceptors: SseInterceptorFn<T>[]): SseFeature[] {\r\n  return interceptors.map(interceptor => ({\r\n    kind: SseFeatureKind.InterceptorFunction,\r\n    interceptor,\r\n  }));\r\n}\r\n","import { InjectionToken } from \"@angular/core\";\r\nimport type { Observable } from \"rxjs\";\r\n\r\n/**\r\n * Represents an SSE request with URL and initialization options.\r\n */\r\nexport interface SseRequest {\r\n  url: string;\r\n  init: EventSourceInit;\r\n}\r\n\r\n/**\r\n * Function type for passing the request to the next handler in the interceptor chain.\r\n */\r\nexport type SseNextFn<T> = (request: SseRequest) => Observable<T>;\r\n\r\n/**\r\n * Functional interceptor type for intercepting SSE requests.\r\n * Interceptors can modify requests, handle errors, add logging, etc.\r\n *\r\n * @example\r\n * ```typescript\r\n * const loggingInterceptor: SseInterceptorFn<any> = (req, next) => {\r\n *   console.log('SSE Request:', req.url);\r\n *   return next(req);\r\n * };\r\n * ```\r\n */\r\nexport type SseInterceptorFn<T> = (\r\n  request: SseRequest,\r\n  next: SseNextFn<T>\r\n) => Observable<T>;\r\n\r\n/**\r\n * Class-based interceptor interface for SSE requests.\r\n * Implements the same pattern as Angular's HttpInterceptor.\r\n */\r\nexport interface SseInterceptor<T = unknown> {\r\n  sseIntercept<U = T>(...args: Parameters<SseInterceptorFn<U>>): ReturnType<SseInterceptorFn<U>>;\r\n}\r\n\r\n/**\r\n * Injection token for providing SSE interceptors.\r\n * Use with multi: true to provide multiple interceptors.\r\n */\r\nexport const SSE_INTERCEPTORS = new InjectionToken<SseInterceptor<unknown>[]>('Telperion/SSE_INTERCEPTORS');\r\n","import { inject, Injectable } from \"@angular/core\";\r\nimport { Observable } from \"rxjs\";\r\n\r\nimport { SSE_INTERCEPTORS, SseRequest } from \"./interceptor\";\r\n\r\n/**\r\n * Angular service for managing Server-Sent Events (SSE) connections.\r\n * Wraps the EventSource API with RxJS Observables and an HttpClient-inspired interceptor chain.\r\n *\r\n * @example\r\n * ```typescript\r\n * class MyComponent {\r\n *   private sseClient = inject(SseClient);\r\n *\r\n *   messages$ = this.sseClient.start<string>('/api/events');\r\n * }\r\n * ```\r\n */\r\n@Injectable()\r\nexport class SseClient {\r\n  #interceptors = inject(SSE_INTERCEPTORS, { optional: true }) ?? [];\r\n\r\n  constructor() {\r\n    if (!(this.#interceptors instanceof Array)) {\r\n      throw new Error('SSE_INTERCEPTORS must be provided as an array. Please ensure you are using multi: true when providing interceptors.');\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Starts a new Server-Sent Events connection and returns an Observable stream.\r\n   *\r\n   * @param url - The URL endpoint for the SSE connection\r\n   * @param init - Optional EventSource initialization configuration\r\n   * @returns Observable stream of server-sent events\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * this.sseClient.start<MessageData>('/api/notifications', { withCredentials: true })\r\n   *   .subscribe(data => console.log('Received:', data));\r\n   * ```\r\n   */\r\n  start<T>(url: string, init: EventSourceInit = {}): Observable<T> {\r\n    return this.#interceptors.reduceRight(\r\n      (next, interceptor) => (req) => interceptor.sseIntercept(req, next),\r\n      (req: SseRequest) => this.#createEventSource(req) as Observable<T>\r\n    )({ url, init });\r\n  }\r\n\r\n  #createEventSource<T>(request: SseRequest): Observable<T> {\r\n    return new Observable<T>((subscriber) => {\r\n      const eventSource = new EventSource(request.url, request.init);\r\n\r\n      function handleMessage(event: MessageEvent) {\r\n        subscriber.next(event.data);\r\n      }\r\n\r\n      function handleError(err: Event) {\r\n        subscriber.error(err);\r\n        eventSource.close();\r\n      }\r\n\r\n      eventSource.addEventListener('message', handleMessage);\r\n      eventSource.addEventListener('error', handleError);\r\n\r\n      return () => {\r\n        eventSource.removeEventListener('message', handleMessage);\r\n        eventSource.removeEventListener('error', handleError);\r\n        eventSource.close();\r\n      };\r\n    });\r\n  }\r\n}\r\n","import { Provider } from \"@angular/core\";\r\n\r\nimport { SseClient } from \"./client\";\r\nimport { SseFeature, SseFeatureKind, SseInterceptorFunctionFeature } from \"./features\";\r\nimport { SSE_INTERCEPTORS } from \"./interceptor\";\r\n\r\n/**\r\n * Provides the SseClient service with optional features.\r\n * Configure SSE client with interceptors and other features using a functional API.\r\n *\r\n * @param features - Optional feature configurations (e.g., withSseInterceptors())\r\n * @returns Array of Angular providers\r\n *\r\n * @example\r\n * ```typescript\r\n * import { provideSseClient, withSseInterceptors } from '@telperion/ng-pack/sse-client';\r\n *\r\n * export const appConfig: ApplicationConfig = {\r\n *   providers: [\r\n *     provideSseClient(\r\n *       withSseInterceptors(loggingInterceptor, authInterceptor)\r\n *     )\r\n *   ]\r\n * };\r\n * ```\r\n */\r\nexport function provideSseClient(...features: SseFeature[][]): Provider[] {\r\n  const interceptorFns = features\r\n    .flat()\r\n    .filter(feature => feature.kind === SseFeatureKind.InterceptorFunction)\r\n    .map(feature => ({\r\n      provide: SSE_INTERCEPTORS,\r\n      useValue: {\r\n        sseIntercept: (feature as SseInterceptorFunctionFeature).interceptor,\r\n      },\r\n      multi: true,\r\n    }));\r\n\r\n  return [\r\n    {\r\n      provide: SseClient,\r\n      useClass: SseClient\r\n    },\r\n    ...interceptorFns\r\n  ];\r\n}\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"telperion-ng-pack-sse-client.mjs","sources":["../../sse-client/src/features/feature.ts","../../sse-client/src/features/with-base-init.ts","../../sse-client/src/features/with-interceptors.ts","../../sse-client/src/interceptor.ts","../../sse-client/src/client.ts","../../sse-client/src/provider.ts","../../sse-client/src/telperion-ng-pack-sse-client.ts"],"sourcesContent":["/**\r\n * Enum identifying different types of SSE features.\r\n */\r\nexport enum SseFeatureKind {\r\n  InterceptorFunction\r\n}\r\n\r\n/**\r\n * Base interface for SSE feature configurations.\r\n */\r\nexport interface SseFeature {\r\n  kind: SseFeatureKind;\r\n}\r\n","import { SseFeature, SseFeatureKind } from \"./feature\";\r\nimport { SseInterceptorFunctionFeature } from \"./with-interceptors\";\r\n\r\n/**\r\n * Configures default EventSource initialization options for the SSE client.\r\n * Merges the provided options into every SSE request's `init` via an interceptor.\r\n *\r\n * @param init - Partial EventSource initialization options to apply as defaults\r\n * @returns Array of SSE features to be used with `provideSseClient()`\r\n *\r\n * @example\r\n * ```typescript\r\n * provideSseClient(\r\n *   withBaseInit({ withCredentials: true })\r\n * )\r\n * ```\r\n */\r\nexport function withBaseInit(init: Partial<EventSourceInit>): SseFeature[] {\r\n  return [\r\n    <SseInterceptorFunctionFeature>{\r\n      kind: SseFeatureKind.InterceptorFunction,\r\n      interceptor(req, next) {\r\n        return next({\r\n          ...req,\r\n          init: {\r\n            ...req.init,\r\n            ...init\r\n          }\r\n        })\r\n      }\r\n    }\r\n  ]\r\n}\r\n","import { SseInterceptorFn } from \"../interceptor\";\r\nimport { SseFeature, SseFeatureKind } from \"./feature\";\r\n\r\n/**\r\n * Feature interface for functional interceptors.\r\n * @internal\r\n */\r\nexport interface SseInterceptorFunctionFeature extends SseFeature {\r\n  kind: SseFeatureKind.InterceptorFunction;\r\n  interceptor: SseInterceptorFn<unknown>;\r\n}\r\n\r\n/**\r\n * Configures functional interceptors for the SSE client.\r\n * Interceptors are executed in the order they are provided.\r\n *\r\n * @param interceptors - One or more functional interceptor functions\r\n * @returns Array of SSE features to be used with provideSseClient()\r\n *\r\n * @example\r\n * ```typescript\r\n * const loggingInterceptor: SseInterceptorFn<any> = (req, next) => {\r\n *   console.log('Connecting to:', req.url);\r\n *   return next(req);\r\n * };\r\n *\r\n * provideSseClient(\r\n *   withSseInterceptors(loggingInterceptor)\r\n * )\r\n * ```\r\n */\r\nexport function withSseInterceptors<T = unknown>(...interceptors: SseInterceptorFn<T>[]): SseFeature[] {\r\n  return interceptors.map(interceptor => ({\r\n    kind: SseFeatureKind.InterceptorFunction,\r\n    interceptor,\r\n  }));\r\n}\r\n","import { InjectionToken } from \"@angular/core\";\r\nimport type { Observable } from \"rxjs\";\r\n\r\n/**\r\n * Represents an SSE request with URL and initialization options.\r\n */\r\nexport interface SseRequest {\r\n  url: string;\r\n  init: EventSourceInit;\r\n}\r\n\r\n/**\r\n * Function type for passing the request to the next handler in the interceptor chain.\r\n */\r\nexport type SseNextFn<T> = (request: SseRequest) => Observable<T>;\r\n\r\n/**\r\n * Functional interceptor type for intercepting SSE requests.\r\n * Interceptors can modify requests, handle errors, add logging, etc.\r\n *\r\n * @example\r\n * ```typescript\r\n * const loggingInterceptor: SseInterceptorFn<any> = (req, next) => {\r\n *   console.log('SSE Request:', req.url);\r\n *   return next(req);\r\n * };\r\n * ```\r\n */\r\nexport type SseInterceptorFn<T> = (\r\n  request: SseRequest,\r\n  next: SseNextFn<T>\r\n) => Observable<T>;\r\n\r\n/**\r\n * Class-based interceptor interface for SSE requests.\r\n * Implements the same pattern as Angular's HttpInterceptor.\r\n */\r\nexport interface SseInterceptor<T = unknown> {\r\n  sseIntercept<U = T>(...args: Parameters<SseInterceptorFn<U>>): ReturnType<SseInterceptorFn<U>>;\r\n}\r\n\r\n/**\r\n * Injection token for providing SSE interceptors.\r\n * Use with multi: true to provide multiple interceptors.\r\n */\r\nexport const SSE_INTERCEPTORS = new InjectionToken<SseInterceptor<unknown>[]>('Telperion/SSE_INTERCEPTORS');\r\n","import { inject, Injectable } from \"@angular/core\";\r\nimport { Observable } from \"rxjs\";\r\n\r\nimport { SSE_INTERCEPTORS, SseRequest } from \"./interceptor\";\r\n\r\n/**\r\n * Angular service for managing Server-Sent Events (SSE) connections.\r\n * Wraps the EventSource API with RxJS Observables and an HttpClient-inspired interceptor chain.\r\n *\r\n * @example\r\n * ```typescript\r\n * class MyComponent {\r\n *   private sseClient = inject(SseClient);\r\n *\r\n *   messages$ = this.sseClient.start<string>('/api/events');\r\n * }\r\n * ```\r\n */\r\n@Injectable()\r\nexport class SseClient {\r\n  #interceptors = inject(SSE_INTERCEPTORS, { optional: true }) ?? [];\r\n\r\n  constructor() {\r\n    if (!(this.#interceptors instanceof Array)) {\r\n      throw new Error('SSE_INTERCEPTORS must be provided as an array. Please ensure you are using multi: true when providing interceptors.');\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Starts a new Server-Sent Events connection and returns an Observable stream.\r\n   *\r\n   * @param url - The URL endpoint for the SSE connection\r\n   * @param init - Optional EventSource initialization configuration\r\n   * @returns Observable stream of server-sent events\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * this.sseClient.start<MessageData>('/api/notifications', { withCredentials: true })\r\n   *   .subscribe(data => console.log('Received:', data));\r\n   * ```\r\n   */\r\n  start<T>(url: string, init: EventSourceInit = {}): Observable<T> {\r\n    return this.#interceptors.reduceRight(\r\n      (next, interceptor) => (req) => interceptor.sseIntercept(req, next),\r\n      (req: SseRequest) => this.#createEventSource(req) as Observable<T>\r\n    )({ url, init });\r\n  }\r\n\r\n  #createEventSource<T>(request: SseRequest): Observable<T> {\r\n    return new Observable<T>((subscriber) => {\r\n      const eventSource = new EventSource(request.url, request.init);\r\n\r\n      function handleMessage(event: MessageEvent) {\r\n        subscriber.next(event.data);\r\n      }\r\n\r\n      function handleError(err: Event) {\r\n        subscriber.error(err);\r\n        eventSource.close();\r\n      }\r\n\r\n      eventSource.addEventListener('message', handleMessage);\r\n      eventSource.addEventListener('error', handleError);\r\n\r\n      return () => {\r\n        eventSource.removeEventListener('message', handleMessage);\r\n        eventSource.removeEventListener('error', handleError);\r\n        eventSource.close();\r\n      };\r\n    });\r\n  }\r\n}\r\n","import { Provider } from \"@angular/core\";\r\n\r\nimport { SseClient } from \"./client\";\r\nimport { SseFeature, SseFeatureKind, SseInterceptorFunctionFeature } from \"./features\";\r\nimport { SSE_INTERCEPTORS } from \"./interceptor\";\r\n\r\n/**\r\n * Provides the SseClient service with optional features.\r\n * Configure SSE client with interceptors and other features using a functional API.\r\n *\r\n * @param features - Optional feature configurations (e.g., withSseInterceptors())\r\n * @returns Array of Angular providers\r\n *\r\n * @example\r\n * ```typescript\r\n * import { provideSseClient, withSseInterceptors } from '@telperion/ng-pack/sse-client';\r\n *\r\n * export const appConfig: ApplicationConfig = {\r\n *   providers: [\r\n *     provideSseClient(\r\n *       withSseInterceptors(loggingInterceptor, authInterceptor)\r\n *     )\r\n *   ]\r\n * };\r\n * ```\r\n */\r\nexport function provideSseClient(...features: SseFeature[][]): Provider[] {\r\n  const interceptorFns = features\r\n    .flat()\r\n    .filter(feature => feature.kind === SseFeatureKind.InterceptorFunction)\r\n    .map(feature => ({\r\n      provide: SSE_INTERCEPTORS,\r\n      useValue: {\r\n        sseIntercept: (feature as SseInterceptorFunctionFeature).interceptor,\r\n      },\r\n      multi: true,\r\n    }));\r\n\r\n  return [\r\n    {\r\n      provide: SseClient,\r\n      useClass: SseClient\r\n    },\r\n    ...interceptorFns\r\n  ];\r\n}\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/fesm2022/telperion-ng-pack-utils.mjs

@@ -3,8 +3,10 @@ import { forwardRef, Inject, Injectable, inject } from '@angular/core';
 import { DOCUMENT } from '@angular/common';
 import { EventManagerPlugin, EVENT_MANAGER_PLUGINS } from '@angular/platform-browser';
 import { HttpClient } from '@angular/common/http';
-import { tryCatch } from '@thalesrc/js-utils/promise/try-catch';
-import { firstValueFrom } from 'rxjs';
+import { tryCatch } from '@telperion/js-utils/promise/try-catch';
+import { firstValueFrom, Observable, from } from 'rxjs';
+import { toSignal as toSignal$1 } from '@angular/core/rxjs-interop';
+import { promisify } from '@telperion/js-utils/promise/promisify';
 
 /**
  * Utility function to create a provider for a directive/component that can be injected as a service.
@@ -161,9 +163,37 @@ function constructFetcher() {
     });
 }
 
+/**
+ * Converts a value, Promise, or Observable into an Angular Signal.
+ * Accepts any of the three source types and normalises them through
+ * `@angular/core/rxjs-interop`'s `toSignal` under the hood.
+ *
+ * @param source - A plain value, Promise, or Observable to convert
+ * @param options - Optional configuration forwarded to Angular's `toSignal`
+ * @returns A read-only Signal that emits the resolved value (or `undefined` until it resolves)
+ *
+ * @example
+ * ```typescript
+ * // From a plain value
+ * const sig = toSignal(42);
+ *
+ * // From a Promise
+ * const sig = toSignal(fetch('/api/data').then(r => r.json()));
+ *
+ * // From an Observable
+ * const sig = toSignal(myService.data$);
+ * ```
+ */
+function toSignal(source, options = {}) {
+    if (!(source instanceof Observable)) {
+        source = promisify(source);
+    }
+    return toSignal$1(from(source), options);
+}
+
 /**
  * Generated bundle index. Do not edit.
  */
 
-export { constructFetcher, provideEventModifiersPlugin, provideServiceDirective };
+export { constructFetcher, provideEventModifiersPlugin, provideServiceDirective, toSignal };
 //# sourceMappingURL=telperion-ng-pack-utils.mjs.map

package/fesm2022/telperion-ng-pack-utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"telperion-ng-pack-utils.mjs","sources":["../../utils/src/provide-service-directive.ts","../../utils/src/event-modifiers.plugin.ts","../../utils/src/construct-fetcher.ts","../../utils/src/telperion-ng-pack-utils.ts"],"sourcesContent":["import { forwardRef, InjectionToken, Provider, Type } from \"@angular/core\";\r\n\r\n/**\r\n * Utility function to create a provider for a directive/component that can be injected as a service.\r\n * This is useful for cases where you want to inject a directive/component instance into another directive/component.\r\n *\r\n * Example usage:\r\n *\r\n * files:\r\n * - parent.directive.ts\r\n * - child.directive.ts\r\n * - parent.service.ts\r\n *\r\n * parent.service.ts:\r\n * ```\r\n * import { InjectionToken } from \"@angular/core\";\r\n * import type { ParentDirective } from \"./parent.directive\";\r\n *\r\n * export const ParentService = new InjectionToken<ParentDirective>(\"ParentService\");\r\n * ```\r\n *\r\n * parent.directive.ts:\r\n * ```\r\n * @Directive({\r\n *   selector: 'parent',\r\n *   providers: [provideServiceDirective(ParentService, ParentDirective)],\r\n * })\r\n * export class ParentDirective {...}\r\n * ```\r\n * child.directive.ts:\r\n * ```\r\n * @Directive({\r\n *   selector: 'child',\r\n * })\r\n * export class ChildDirective {\r\n *   #parent = inject(ParentService);\r\n * }\r\n * ```\r\n *\r\n * @param token - The injection token to provide.\r\n * @param directive - The directive/component class that will be provided.\r\n * @returns A provider object that can be used in the providers array of an Angular module or component.\r\n */\r\nexport function provideServiceDirective<T>(\r\n  token: InjectionToken<T>,\r\n  directive: Type<NoInfer<T>>\r\n): Provider {\r\n  return {\r\n    provide: token,\r\n    useExisting: forwardRef(() => directive)\r\n  }\r\n}\r\n","/**\r\n * Angular Event Manager Plugin that enables event modifier syntax in templates.\r\n *\r\n * @example\r\n * ```html\r\n * <form (submit.pd)=\"onSubmit()\">...</form>\r\n * <div (click.sp)=\"handleClick()\">...</div>\r\n * <button (click.pd.sp)=\"handleButtonClick()\">Click me</button>\r\n * ```\r\n */\r\n\r\nimport { DOCUMENT } from '@angular/common';\r\nimport { Inject, Injectable, Provider } from '@angular/core';\r\nimport { EVENT_MANAGER_PLUGINS, EventManagerPlugin } from '@angular/platform-browser';\r\n\r\n/**\r\n * Event Manager Plugin that adds support for event modifiers.\r\n * @internal\r\n */\r\n@Injectable()\r\nexport class EventModifiersPlugin extends EventManagerPlugin {\r\n  /**\r\n   * Supported modifiers: `pd` (preventDefault), `sp` (stopPropagation)\r\n   */\r\n  private static modifierMap: { [key: string]: (e: Event) => void } = {\r\n    'pd': (e: Event) => e.preventDefault(),\r\n    'sp': (e: Event) => e.stopPropagation(),\r\n  };\r\n\r\n  constructor(@Inject(DOCUMENT) doc: Document) {\r\n    super(doc);\r\n  }\r\n\r\n  supports(eventName: string): boolean {\r\n    return eventName.includes('.') &&\r\n      eventName.split('.').some(part => part in EventModifiersPlugin.modifierMap);\r\n  }\r\n\r\n  addEventListener(element: HTMLElement, eventName: string, handler: (event: Event) => void): () => void {\r\n    const parts = eventName.split('.');\r\n    const domEventName = parts[0];\r\n    const modifiers = parts.slice(1).filter(m => m in EventModifiersPlugin.modifierMap);\r\n\r\n    const wrappedHandler = (event: Event) => {\r\n      modifiers.forEach(mod => EventModifiersPlugin.modifierMap[mod](event));\r\n\r\n      return handler(event);\r\n    };\r\n\r\n    element.addEventListener(domEventName, wrappedHandler);\r\n\r\n    return () => element.removeEventListener(domEventName, wrappedHandler);\r\n  }\r\n}\r\n\r\n/**\r\n * Provides the Event Modifiers Plugin.\r\n *\r\n * @example\r\n * ```typescript\r\n * bootstrapApplication(AppComponent, {\r\n *   providers: [provideEventModifiersPlugin()]\r\n * });\r\n * ```\r\n */\r\nexport function provideEventModifiersPlugin(): Provider {\r\n  return {\r\n    provide: EVENT_MANAGER_PLUGINS,\r\n    useClass: EventModifiersPlugin,\r\n    multi: true\r\n  };\r\n}\r\n","import { HttpClient } from \"@angular/common/http\";\nimport { inject } from \"@angular/core\";\nimport { AnyFunction } from '@thalesrc/extra-ts-types';\nimport { tryCatch } from \"@thalesrc/js-utils/promise/try-catch\";\nimport { firstValueFrom, Observable } from 'rxjs';\n\nexport type Fetcher = {\n  [P in keyof HttpClient]: HttpClient[P] extends (...args: infer A) => Observable<unknown> ? <T>(...args: A) => Promise<[unknown, T]> : never;\n}\n\n/**\n * Constructs a Fetcher that proxies HttpClient methods and returns a tuple of [error, response].\n * If the HttpClient method throws an error, it will be caught and returned as the first element of the tuple.\n * If the HttpClient method succeeds, the response will be returned as the second element of the tuple.\n * Example usage:\n * ```\n * @Component({\n *   selector: 'app-example',\n *   template: `<button (click)=\"fetchData()\">Fetch Data</button>`,\n * })\n * export class ExampleComponent {\n *   private fetcher = constructFetcher();\n *\n *   async fetchData() {\n *    const [error, response] = await this.fetcher.get('/api/data');\n *\n*     if (error) {\n*       console.error('Error fetching data:', error);\n*     } else {\n*       console.log('Fetched data:', response);\n*     }\n *   }\n * }\n * ```\n */\nexport function constructFetcher() {\n  const client = inject(HttpClient);\n\n  return new Proxy({} as Fetcher, {\n    get(target, prop) {\n      if (prop in client) {\n        return (...args: any[]) => {\n          const method = (client as any)[prop] as AnyFunction;\n\n          return tryCatch(firstValueFrom(method.apply(client, args)));\n        }\n      }\n\n      throw new Error(`HttpClient does not have method ${String(prop)}`);\n    }\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"telperion-ng-pack-utils.mjs","sources":["../../utils/src/provide-service-directive.ts","../../utils/src/event-modifiers.plugin.ts","../../utils/src/construct-fetcher.ts","../../utils/src/to-signal.ts","../../utils/src/telperion-ng-pack-utils.ts"],"sourcesContent":["import { forwardRef, InjectionToken, Provider, Type } from \"@angular/core\";\r\n\r\n/**\r\n * Utility function to create a provider for a directive/component that can be injected as a service.\r\n * This is useful for cases where you want to inject a directive/component instance into another directive/component.\r\n *\r\n * Example usage:\r\n *\r\n * files:\r\n * - parent.directive.ts\r\n * - child.directive.ts\r\n * - parent.service.ts\r\n *\r\n * parent.service.ts:\r\n * ```\r\n * import { InjectionToken } from \"@angular/core\";\r\n * import type { ParentDirective } from \"./parent.directive\";\r\n *\r\n * export const ParentService = new InjectionToken<ParentDirective>(\"ParentService\");\r\n * ```\r\n *\r\n * parent.directive.ts:\r\n * ```\r\n * @Directive({\r\n *   selector: 'parent',\r\n *   providers: [provideServiceDirective(ParentService, ParentDirective)],\r\n * })\r\n * export class ParentDirective {...}\r\n * ```\r\n * child.directive.ts:\r\n * ```\r\n * @Directive({\r\n *   selector: 'child',\r\n * })\r\n * export class ChildDirective {\r\n *   #parent = inject(ParentService);\r\n * }\r\n * ```\r\n *\r\n * @param token - The injection token to provide.\r\n * @param directive - The directive/component class that will be provided.\r\n * @returns A provider object that can be used in the providers array of an Angular module or component.\r\n */\r\nexport function provideServiceDirective<T>(\r\n  token: InjectionToken<T>,\r\n  directive: Type<NoInfer<T>>\r\n): Provider {\r\n  return {\r\n    provide: token,\r\n    useExisting: forwardRef(() => directive)\r\n  }\r\n}\r\n","/**\r\n * Angular Event Manager Plugin that enables event modifier syntax in templates.\r\n *\r\n * @example\r\n * ```html\r\n * <form (submit.pd)=\"onSubmit()\">...</form>\r\n * <div (click.sp)=\"handleClick()\">...</div>\r\n * <button (click.pd.sp)=\"handleButtonClick()\">Click me</button>\r\n * ```\r\n */\r\n\r\nimport { DOCUMENT } from '@angular/common';\r\nimport { Inject, Injectable, Provider } from '@angular/core';\r\nimport { EVENT_MANAGER_PLUGINS, EventManagerPlugin } from '@angular/platform-browser';\r\n\r\n/**\r\n * Event Manager Plugin that adds support for event modifiers.\r\n * @internal\r\n */\r\n@Injectable()\r\nexport class EventModifiersPlugin extends EventManagerPlugin {\r\n  /**\r\n   * Supported modifiers: `pd` (preventDefault), `sp` (stopPropagation)\r\n   */\r\n  private static modifierMap: { [key: string]: (e: Event) => void } = {\r\n    'pd': (e: Event) => e.preventDefault(),\r\n    'sp': (e: Event) => e.stopPropagation(),\r\n  };\r\n\r\n  constructor(@Inject(DOCUMENT) doc: Document) {\r\n    super(doc);\r\n  }\r\n\r\n  supports(eventName: string): boolean {\r\n    return eventName.includes('.') &&\r\n      eventName.split('.').some(part => part in EventModifiersPlugin.modifierMap);\r\n  }\r\n\r\n  addEventListener(element: HTMLElement, eventName: string, handler: (event: Event) => void): () => void {\r\n    const parts = eventName.split('.');\r\n    const domEventName = parts[0];\r\n    const modifiers = parts.slice(1).filter(m => m in EventModifiersPlugin.modifierMap);\r\n\r\n    const wrappedHandler = (event: Event) => {\r\n      modifiers.forEach(mod => EventModifiersPlugin.modifierMap[mod](event));\r\n\r\n      return handler(event);\r\n    };\r\n\r\n    element.addEventListener(domEventName, wrappedHandler);\r\n\r\n    return () => element.removeEventListener(domEventName, wrappedHandler);\r\n  }\r\n}\r\n\r\n/**\r\n * Provides the Event Modifiers Plugin.\r\n *\r\n * @example\r\n * ```typescript\r\n * bootstrapApplication(AppComponent, {\r\n *   providers: [provideEventModifiersPlugin()]\r\n * });\r\n * ```\r\n */\r\nexport function provideEventModifiersPlugin(): Provider {\r\n  return {\r\n    provide: EVENT_MANAGER_PLUGINS,\r\n    useClass: EventModifiersPlugin,\r\n    multi: true\r\n  };\r\n}\r\n","import { HttpClient } from \"@angular/common/http\";\nimport { inject } from \"@angular/core\";\nimport { AnyFunction } from '@telperion/extra-ts-types';\nimport { tryCatch } from \"@telperion/js-utils/promise/try-catch\";\nimport { firstValueFrom, Observable } from 'rxjs';\n\nexport type Fetcher = {\n  [P in keyof HttpClient]: HttpClient[P] extends (...args: infer A) => Observable<unknown> ? <T>(...args: A) => Promise<[unknown, T]> : never;\n}\n\n/**\n * Constructs a Fetcher that proxies HttpClient methods and returns a tuple of [error, response].\n * If the HttpClient method throws an error, it will be caught and returned as the first element of the tuple.\n * If the HttpClient method succeeds, the response will be returned as the second element of the tuple.\n * Example usage:\n * ```\n * @Component({\n *   selector: 'app-example',\n *   template: `<button (click)=\"fetchData()\">Fetch Data</button>`,\n * })\n * export class ExampleComponent {\n *   private fetcher = constructFetcher();\n *\n *   async fetchData() {\n *    const [error, response] = await this.fetcher.get('/api/data');\n *\n*     if (error) {\n*       console.error('Error fetching data:', error);\n*     } else {\n*       console.log('Fetched data:', response);\n*     }\n *   }\n * }\n * ```\n */\nexport function constructFetcher() {\n  const client = inject(HttpClient);\n\n  return new Proxy({} as Fetcher, {\n    get(target, prop) {\n      if (prop in client) {\n        return (...args: any[]) => {\n          const method = (client as any)[prop] as AnyFunction;\n\n          return tryCatch(firstValueFrom(method.apply(client, args)));\n        }\n      }\n\n      throw new Error(`HttpClient does not have method ${String(prop)}`);\n    }\n  });\n}\n","import { Signal } from \"@angular/core\";\r\nimport { toSignal as ngToSignal } from \"@angular/core/rxjs-interop\";\r\nimport { from, Observable } from \"rxjs\";\r\nimport { promisify } from '@telperion/js-utils/promise/promisify';\r\n\r\n/**\r\n * Converts a value, Promise, or Observable into an Angular Signal.\r\n * Accepts any of the three source types and normalises them through\r\n * `@angular/core/rxjs-interop`'s `toSignal` under the hood.\r\n *\r\n * @param source - A plain value, Promise, or Observable to convert\r\n * @param options - Optional configuration forwarded to Angular's `toSignal`\r\n * @returns A read-only Signal that emits the resolved value (or `undefined` until it resolves)\r\n *\r\n * @example\r\n * ```typescript\r\n * // From a plain value\r\n * const sig = toSignal(42);\r\n *\r\n * // From a Promise\r\n * const sig = toSignal(fetch('/api/data').then(r => r.json()));\r\n *\r\n * // From an Observable\r\n * const sig = toSignal(myService.data$);\r\n * ```\r\n */\r\nexport function toSignal<T>(\r\n  source: T | Promise<T> | Observable<T>,\r\n  options: Partial<Parameters<typeof ngToSignal<T>>[1]> = {}\r\n): Signal<T | undefined> {\r\n  if (!(source instanceof Observable)) {\r\n    source = promisify(source);\r\n  }\r\n\r\n  return ngToSignal(from(source), options as Parameters<typeof ngToSignal<T>>[1]);\r\n}\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":["ngToSignal"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telperion/ng-pack",
-  "version": "1.4.2",
+  "version": "1.6.0",
   "description": "Collection of Angular utilities and libraries organized as secondary entry points. Includes signal-based storage (localStorage/sessionStorage/cookieStorage), SSE client with HttpClient-inspired interceptors, event modifier plugins, and more. Built with TypeScript, RxJS, and Angular Signals for modern Angular applications.",
   "keywords": [
     "angular",
@@ -23,7 +23,9 @@
     "httpclient",
     "secondary-entrypoint",
     "angular-utilities",
-    "event-manager"
+    "event-manager",
+    "promise",
+    "toSignal"
   ],
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -32,8 +34,8 @@
     "rxjs": "^7.8.1"
   },
   "dependencies": {
-    "@thalesrc/extra-ts-types": "^1.4.0",
-    "@thalesrc/js-utils": "^3.4.0",
+    "@telperion/extra-ts-types": "^1.5.0",
+    "@telperion/js-utils": "^3.5.0",
     "@telperion/reactive-storage": "^1.2.0",
     "tslib": "^2.3.0"
   },

package/sse-client/README.md

@@ -373,6 +373,25 @@ export class SecureFeedComponent {
 }
 ```
 
+#### Base Init Configuration
+
+Use `withBaseInit()` to set default `EventSourceInit` options for all SSE connections:
+
+```typescript
+import { ApplicationConfig } from '@angular/core';
+import { provideSseClient, withBaseInit } from '@telperion/ng-pack/sse-client';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideSseClient(
+      withBaseInit({ withCredentials: true })
+    )
+  ]
+};
+```
+
+Options provided via `withBaseInit()` are merged into every request and can be overridden per-call through `SseClient.start()`.
+
 ## API Reference
 
 ### `provideSseClient(...features: SseFeature[][]): Provider[]`
@@ -435,6 +454,24 @@ withSseInterceptors(
 
 ---
 
+### `withBaseInit(init: Partial<EventSourceInit>): SseFeature[]`
+
+Configures default `EventSourceInit` options that are merged into every SSE request.
+
+**Parameters:**
+- `init` - Partial EventSource initialization options (e.g., `{ withCredentials: true }`)
+
+**Returns:** Array of SSE features to be used with `provideSseClient()`
+
+**Example:**
+```typescript
+provideSseClient(
+  withBaseInit({ withCredentials: true })
+)
+```
+
+---
+
 ### `SseInterceptorFn<T>`
 
 Type definition for functional interceptors.

package/types/telperion-ng-pack-sse-client.d.ts

@@ -15,6 +15,22 @@ interface SseFeature {
     kind: SseFeatureKind;
 }
 
+/**
+ * Configures default EventSource initialization options for the SSE client.
+ * Merges the provided options into every SSE request's `init` via an interceptor.
+ *
+ * @param init - Partial EventSource initialization options to apply as defaults
+ * @returns Array of SSE features to be used with `provideSseClient()`
+ *
+ * @example
+ * ```typescript
+ * provideSseClient(
+ *   withBaseInit({ withCredentials: true })
+ * )
+ * ```
+ */
+declare function withBaseInit(init: Partial<EventSourceInit>): SseFeature[];
+
 /**
  * Represents an SSE request with URL and initialization options.
  */
@@ -137,5 +153,5 @@ declare class SseClient {
  */
 declare function provideSseClient(...features: SseFeature[][]): Provider[];
 
-export { SSE_INTERCEPTORS, SseClient, SseFeatureKind, provideSseClient, withSseInterceptors };
+export { SSE_INTERCEPTORS, SseClient, SseFeatureKind, provideSseClient, withBaseInit, withSseInterceptors };
 export type { SseFeature, SseInterceptor, SseInterceptorFn, SseInterceptorFunctionFeature, SseNextFn, SseRequest };

package/types/telperion-ng-pack-utils.d.ts

@@ -1,6 +1,7 @@
-import { InjectionToken, Type, Provider } from '@angular/core';
+import { InjectionToken, Type, Provider, Signal } from '@angular/core';
 import { HttpClient } from '@angular/common/http';
 import { Observable } from 'rxjs';
+import { toSignal as toSignal$1 } from '@angular/core/rxjs-interop';
 
 /**
  * Utility function to create a provider for a directive/component that can be injected as a service.
@@ -87,4 +88,27 @@ type Fetcher = {
  */
 declare function constructFetcher(): Fetcher;
 
-export { constructFetcher, provideEventModifiersPlugin, provideServiceDirective };
+/**
+ * Converts a value, Promise, or Observable into an Angular Signal.
+ * Accepts any of the three source types and normalises them through
+ * `@angular/core/rxjs-interop`'s `toSignal` under the hood.
+ *
+ * @param source - A plain value, Promise, or Observable to convert
+ * @param options - Optional configuration forwarded to Angular's `toSignal`
+ * @returns A read-only Signal that emits the resolved value (or `undefined` until it resolves)
+ *
+ * @example
+ * ```typescript
+ * // From a plain value
+ * const sig = toSignal(42);
+ *
+ * // From a Promise
+ * const sig = toSignal(fetch('/api/data').then(r => r.json()));
+ *
+ * // From an Observable
+ * const sig = toSignal(myService.data$);
+ * ```
+ */
+declare function toSignal<T>(source: T | Promise<T> | Observable<T>, options?: Partial<Parameters<typeof toSignal$1<T>>[1]>): Signal<T | undefined>;
+
+export { constructFetcher, provideEventModifiersPlugin, provideServiceDirective, toSignal };

package/utils/README.md

@@ -242,6 +242,36 @@ All methods return a Promise that resolves to a tuple:
 4. **DI integration**: Works seamlessly with Angular's dependency injection
 5. **Clean code**: Reduces boilerplate and improves readability
 
+### toSignal
+
+A unified helper that converts a plain value, a Promise, or an Observable into an Angular `Signal`. It normalises the input through `@angular/core/rxjs-interop`'s `toSignal`, so you can use a single call regardless of the source type.
+
+#### Usage
+
+```typescript
+import { toSignal } from '@telperion/ng-pack/utils';
+
+// From a plain value
+const count = toSignal(42);
+
+// From a Promise
+const user = toSignal(fetch('/api/me').then(r => r.json()));
+
+// From an Observable
+const messages = toSignal(this.messageService.messages$);
+
+// With options (forwarded to Angular's toSignal)
+const data = toSignal(this.dataService.data$, { initialValue: [] });
+```
+
+#### API
+
+`toSignal<T>(source: T | Promise<T> | Observable<T>, options?): Signal<T | undefined>`
+
+- `source` - A plain value, Promise, or Observable
+- `options` (optional) - Configuration forwarded to Angular's `toSignal` (e.g., `{ initialValue }` )
+- Returns a read-only `Signal<T | undefined>`
+
 ## License
 
 MIT