@rt-tools/core 0.0.1

package/README.md

@@ -0,0 +1,84 @@
+# @rt-tools/core
+
+Core utilities for Angular applications.
+
+## Installation
+
+```bash
+npm install @rt-tools/core
+# or
+pnpm add @rt-tools/core
+```
+
+## Features
+
+### isNil
+Type guard function for null/undefined checks.
+
+```typescript
+import { isNil } from '@rt-tools/core';
+
+if (isNil(value)) {
+    // value is null or undefined
+}
+```
+
+### MessageBus
+Event bus for component communication using RxJS.
+
+```typescript
+import { MessageBus } from '@rt-tools/core';
+
+const bus = new MessageBus<'USER_LOGGED_IN' | 'USER_LOGGED_OUT'>();
+
+// Subscribe to events
+bus.ofType('USER_LOGGED_IN').subscribe(event => {
+    console.log('User logged in');
+});
+
+// Emit events
+bus.emit({ type: 'USER_LOGGED_IN' });
+```
+
+### PlatformService
+Service for detecting browser/server platform.
+
+```typescript
+import { PlatformService } from '@rt-tools/core';
+
+@Component({...})
+export class MyComponent {
+    private platform = inject(PlatformService);
+
+    ngOnInit() {
+        if (this.platform.isPlatformBrowser) {
+            // Browser-only code
+        }
+    }
+}
+```
+
+### WINDOW Token
+Injection token for safe window access.
+
+```typescript
+import { WINDOW } from '@rt-tools/core';
+
+@Component({...})
+export class MyComponent {
+    private window = inject(WINDOW);
+
+    scrollToTop() {
+        this.window.scrollTo(0, 0);
+    }
+}
+```
+
+## Requirements
+
+- Angular 21+
+- RxJS 7.8+
+
+## License
+
+Apache-2.0

package/fesm2022/rt-tools-core.mjs

@@ -0,0 +1,59 @@
+import { Subject } from 'rxjs';
+import { filter, map } from 'rxjs/operators';
+import { isPlatformBrowser, DOCUMENT } from '@angular/common';
+import * as i0 from '@angular/core';
+import { inject, PLATFORM_ID, Injectable, InjectionToken } from '@angular/core';
+
+function isNil(entity) {
+    return entity === null || entity === undefined;
+}
+
+class MessageBus {
+    #eventSource = new Subject();
+    emit(event) {
+        this.#eventSource.next(event);
+    }
+    onEmit() {
+        return this.#eventSource.asObservable();
+    }
+    ofType(eventType) {
+        return this.onEmit().pipe(filter((event) => event.type === eventType), map((event) => event));
+    }
+}
+
+/**
+ * A service for detecting the platform on which the application is running.
+ * This service is useful for checking if the application is running in a browser
+ * environment or on the server-side.
+ */
+class PlatformService {
+    #platformId = inject(PLATFORM_ID);
+    constructor() {
+        this.isPlatformBrowser = isPlatformBrowser(this.#platformId);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.0.1", ngImport: i0, type: PlatformService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.0.1", ngImport: i0, type: PlatformService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.0.1", ngImport: i0, type: PlatformService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [] });
+
+const WINDOW = new InjectionToken('An injection token for global window object', {
+    factory: () => {
+        const { defaultView } = inject(DOCUMENT);
+        if (!defaultView) {
+            throw new Error('Window is not available');
+        }
+        return defaultView;
+    },
+});
+
+// functions
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { MessageBus, PlatformService, WINDOW, isNil };
+//# sourceMappingURL=rt-tools-core.mjs.map

package/fesm2022/rt-tools-core.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rt-tools-core.mjs","sources":["../../../projects/core/src/lib/functions/is-nil.ts","../../../projects/core/src/lib/services/message-bus.ts","../../../projects/core/src/lib/services/platform.service.ts","../../../projects/core/src/lib/tokens/window.token.ts","../../../projects/core/src/index.ts","../../../projects/core/src/rt-tools-core.ts"],"sourcesContent":["export function isNil<T>(entity: T | null | undefined): entity is null | undefined {\n    return entity === null || entity === undefined;\n}\n","import { Observable, Subject } from 'rxjs';\nimport { filter, map } from 'rxjs/operators';\n\nexport interface MessageBusEvent<T = string> {\n    readonly type: T;\n}\n\nexport class MessageBus<M> {\n    readonly #eventSource: Subject<MessageBusEvent<M>> = new Subject<MessageBusEvent<M>>();\n\n    public emit(event: MessageBusEvent<M>): void {\n        this.#eventSource.next(event);\n    }\n\n    public onEmit(): Observable<MessageBusEvent<M>> {\n        return this.#eventSource.asObservable();\n    }\n\n    public ofType(eventType: M): Observable<MessageBusEvent<M>> {\n        return this.onEmit().pipe(\n            filter((event: MessageBusEvent<M>): event is MessageBusEvent<M> => event.type === eventType),\n            map((event: MessageBusEvent<M>) => event)\n        );\n    }\n}\n","import { isPlatformBrowser } from '@angular/common';\nimport { Injectable, PLATFORM_ID, inject } from '@angular/core';\n\n/**\n * A service for detecting the platform on which the application is running.\n * This service is useful for checking if the application is running in a browser\n * environment or on the server-side.\n */\n@Injectable({ providedIn: 'root' })\nexport class PlatformService {\n    readonly #platformId: object = inject(PLATFORM_ID);\n    public readonly isPlatformBrowser: boolean;\n\n    constructor() {\n        this.isPlatformBrowser = isPlatformBrowser(this.#platformId);\n    }\n}\n","import { DOCUMENT } from '@angular/common';\nimport { InjectionToken, inject } from '@angular/core';\n\nexport const WINDOW: InjectionToken<Window> = new InjectionToken<Window>('An injection token for global window object', {\n    factory: (): Window => {\n        const { defaultView }: Document = inject(DOCUMENT);\n\n        if (!defaultView) {\n            throw new Error('Window is not available');\n        }\n\n        return defaultView;\n    },\n});\n","// functions\nexport * from './lib/functions';\n\n// services\nexport * from './lib/services';\n\n// tokens\nexport * from './lib/tokens';\n\n// types\nexport * from './lib/types';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;AAAM,SAAU,KAAK,CAAI,MAA4B,EAAA;AACjD,IAAA,OAAO,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;AAClD;;MCKa,UAAU,CAAA;AACV,IAAA,YAAY,GAAgC,IAAI,OAAO,EAAsB;AAE/E,IAAA,IAAI,CAAC,KAAyB,EAAA;AACjC,QAAA,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;IACjC;IAEO,MAAM,GAAA;AACT,QAAA,OAAO,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE;IAC3C;AAEO,IAAA,MAAM,CAAC,SAAY,EAAA;AACtB,QAAA,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CACrB,MAAM,CAAC,CAAC,KAAyB,KAAkC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,EAC5F,GAAG,CAAC,CAAC,KAAyB,KAAK,KAAK,CAAC,CAC5C;IACL;AACH;;ACrBD;;;;AAIG;MAEU,eAAe,CAAA;AACf,IAAA,WAAW,GAAW,MAAM,CAAC,WAAW,CAAC;AAGlD,IAAA,WAAA,GAAA;QACI,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC;IAChE;8GANS,eAAe,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA,CAAA;AAAf,IAAA,SAAA,IAAA,CAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,eAAe,cADF,MAAM,EAAA,CAAA,CAAA;;2FACnB,eAAe,EAAA,UAAA,EAAA,CAAA;kBAD3B,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE;;;MCLrB,MAAM,GAA2B,IAAI,cAAc,CAAS,6CAA6C,EAAE;IACpH,OAAO,EAAE,MAAa;QAClB,MAAM,EAAE,WAAW,EAAE,GAAa,MAAM,CAAC,QAAQ,CAAC;QAElD,IAAI,CAAC,WAAW,EAAE;AACd,YAAA,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;QAC9C;AAEA,QAAA,OAAO,WAAW;IACtB,CAAC;AACJ,CAAA;;ACbD;;ACAA;;AAEG;;;;"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@rt-tools/core",
+  "version": "0.0.1",
+  "description": "Core utilities for Angular applications - MessageBus, PlatformService, WINDOW token, and helper functions",
+  "license": "Apache-2.0",
+  "author": "Yauheni Krumin",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Eyhenij/rt-tools",
+    "directory": "projects/core"
+  },
+  "keywords": [
+    "Angular",
+    "Core",
+    "Utils",
+    "MessageBus",
+    "Signals"
+  ],
+  "peerDependencies": {
+    "@angular/common": "^21.0.0",
+    "@angular/core": "^21.0.0",
+    "rxjs": "^7.8.0"
+  },
+  "sideEffects": false,
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "module": "fesm2022/rt-tools-core.mjs",
+  "typings": "types/rt-tools-core.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/rt-tools-core.d.ts",
+      "default": "./fesm2022/rt-tools-core.mjs"
+    }
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

package/types/rt-tools-core.d.ts

@@ -0,0 +1,41 @@
+import { Observable } from 'rxjs';
+import * as i0 from '@angular/core';
+import { InjectionToken } from '@angular/core';
+
+declare function isNil<T>(entity: T | null | undefined): entity is null | undefined;
+
+interface MessageBusEvent<T = string> {
+    readonly type: T;
+}
+declare class MessageBus<M> {
+    #private;
+    emit(event: MessageBusEvent<M>): void;
+    onEmit(): Observable<MessageBusEvent<M>>;
+    ofType(eventType: M): Observable<MessageBusEvent<M>>;
+}
+
+/**
+ * A service for detecting the platform on which the application is running.
+ * This service is useful for checking if the application is running in a browser
+ * environment or on the server-side.
+ */
+declare class PlatformService {
+    #private;
+    readonly isPlatformBrowser: boolean;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<PlatformService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PlatformService>;
+}
+
+declare const WINDOW: InjectionToken<Window>;
+
+interface IDictionary<T> {
+    [Key: string]: T;
+}
+
+type Nullable<T> = T | undefined | null;
+
+type Primitive = string | number | bigint | boolean | symbol | null | undefined;
+
+export { MessageBus, PlatformService, WINDOW, isNil };
+export type { IDictionary, MessageBusEvent, Nullable, Primitive };