@telperion/ng-pack 1.5.0 → 1.6.0

package/README.md

@@ -200,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-utils.mjs

@@ -4,7 +4,9 @@ import { DOCUMENT } from '@angular/common';
 import { EventManagerPlugin, EVENT_MANAGER_PLUGINS } from '@angular/platform-browser';
 import { HttpClient } from '@angular/common/http';
 import { tryCatch } from '@telperion/js-utils/promise/try-catch';
-import { firstValueFrom } from 'rxjs';
+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 '@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","/**\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.5.0",
+  "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",

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