ngx-firestore-wrapper-kit 0.0.1

package/README.md

@@ -0,0 +1,63 @@
+# NgxFirestoreKit
+
+This project was generated using [Angular CLI](https://github.com/angular/angular-cli) version 20.3.0.
+
+## Code scaffolding
+
+Angular CLI includes powerful code scaffolding tools. To generate a new component, run:
+
+```bash
+ng generate component component-name
+```
+
+For a complete list of available schematics (such as `components`, `directives`, or `pipes`), run:
+
+```bash
+ng generate --help
+```
+
+## Building
+
+To build the library, run:
+
+```bash
+ng build ngx-firestore-kit
+```
+
+This command will compile your project, and the build artifacts will be placed in the `dist/` directory.
+
+### Publishing the Library
+
+Once the project is built, you can publish your library by following these steps:
+
+1. Navigate to the `dist` directory:
+   ```bash
+   cd dist/ngx-firestore-kit
+   ```
+
+2. Run the `npm publish` command to publish your library to the npm registry:
+   ```bash
+   npm publish
+   ```
+
+## Running unit tests
+
+To execute unit tests with the [Karma](https://karma-runner.github.io) test runner, use the following command:
+
+```bash
+ng test
+```
+
+## Running end-to-end tests
+
+For end-to-end (e2e) testing, run:
+
+```bash
+ng e2e
+```
+
+Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs.
+
+## Additional Resources
+
+For more information on using the Angular CLI, including detailed command references, visit the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.

package/fesm2022/goc-ngx-firestore-kit.mjs

@@ -0,0 +1,109 @@
+import * as i0 from '@angular/core';
+import { Component, inject, Injector, runInInjectionContext, Injectable, makeEnvironmentProviders } from '@angular/core';
+import { Firestore, doc, docData, collection, collectionChanges, provideFirestore, getFirestore } from '@angular/fire/firestore';
+import { of } from 'rxjs';
+import { filter, map, catchError } from 'rxjs/operators';
+import { provideFirebaseApp, initializeApp } from '@angular/fire/app';
+
+class NgxFirestoreKit {
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: NgxFirestoreKit, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.23", type: NgxFirestoreKit, isStandalone: true, selector: "lib-ngx-firestore-kit", ngImport: i0, template: `
+    <p>
+      ngx-firestore-kit works!
+    </p>
+  `, isInline: true, styles: [""] });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: NgxFirestoreKit, decorators: [{
+            type: Component,
+            args: [{ selector: 'lib-ngx-firestore-kit', imports: [], template: `
+    <p>
+      ngx-firestore-kit works!
+    </p>
+  ` }]
+        }] });
+
+class FirestoreDataService {
+    firestore = inject(Firestore);
+    injector = inject(Injector);
+    /**
+     * Listen realtime document changes
+     */
+    listenToDocument(pathSegments) {
+        const documentRef = doc(this.firestore, pathSegments[0], ...pathSegments.slice(1));
+        return runInInjectionContext(this.injector, () => docData(documentRef)).pipe(
+        // Cast the response to the expected type
+        filter((response) => response != null), 
+        // Return the response
+        map((response) => ({ success: true, data: response, error: null })), 
+        // Handle errors
+        catchError((error) => {
+            console.error('[Firestore Document Listener Error]', error);
+            return of({ success: false, data: null, error });
+        }));
+    }
+    /**
+     * Listen realtime collection changes
+     */
+    listenToCollection(collectionPath) {
+        const collectionRef = collection(this.firestore, collectionPath[0], ...collectionPath.slice(1));
+        return runInInjectionContext(this.injector, () => collectionChanges(collectionRef)).pipe(
+        // Cast the response to the expected type
+        map((response) => ({ success: true, data: response, error: null })), 
+        // Handle errors
+        catchError((error) => {
+            console.error('[Firestore Collection Listener Error]', error);
+            return of({ success: false, data: null, error });
+        }));
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: FirestoreDataService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: FirestoreDataService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: FirestoreDataService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root'
+                }]
+        }] });
+
+class FirestorePaths {
+    static CLIENTS_COLLECTION = 'clients';
+    static BATCH_JOBS_COLLECTION = 'batchJobs';
+    static getBatchJobDocumentPath(clientId, batchJobDocumentId) {
+        return [
+            FirestorePaths.CLIENTS_COLLECTION,
+            clientId,
+            FirestorePaths.BATCH_JOBS_COLLECTION,
+            batchJobDocumentId
+        ];
+    }
+    static getBatchJobCollectionPath(clientId) {
+        return [
+            FirestorePaths.CLIENTS_COLLECTION,
+            clientId,
+            FirestorePaths.BATCH_JOBS_COLLECTION
+        ];
+    }
+}
+
+/**
+ * Custom library provider that configures and initializes Firebase and Firestore
+ * behind the scenes for the consuming application.
+ */
+function provideFirestoreKit(firebaseConfig) {
+    return makeEnvironmentProviders([
+        // The library handles the Angular Fire initialization boilerplate internally
+        provideFirebaseApp(() => initializeApp(firebaseConfig)),
+        provideFirestore(() => getFirestore())
+    ]);
+}
+
+/*
+ * Public API Surface of ngx-firestore-kit
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { FirestoreDataService, FirestorePaths, NgxFirestoreKit, provideFirestoreKit };
+//# sourceMappingURL=goc-ngx-firestore-kit.mjs.map

package/fesm2022/goc-ngx-firestore-kit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"goc-ngx-firestore-kit.mjs","sources":["../../../projects/ngx-firestore-kit/src/lib/ngx-firestore-kit.ts","../../../projects/ngx-firestore-kit/src/lib/service/firestore-data.service.ts","../../../projects/ngx-firestore-kit/src/lib/service/firestore-paths.ts","../../../projects/ngx-firestore-kit/src/lib/service/firestore-providers.ts","../../../projects/ngx-firestore-kit/src/public-api.ts","../../../projects/ngx-firestore-kit/src/goc-ngx-firestore-kit.ts"],"sourcesContent":["import { Component } from '@angular/core';\r\n\r\n@Component({\r\n  selector: 'lib-ngx-firestore-kit',\r\n  imports: [],\r\n  template: `\r\n    <p>\r\n      ngx-firestore-kit works!\r\n    </p>\r\n  `,\r\n  styles: ``,\r\n})\r\nexport class NgxFirestoreKit {\r\n\r\n}\r\n","import { Injectable, Injector, inject, runInInjectionContext } from '@angular/core';\r\nimport { Firestore, collection, collectionChanges, doc, docData } from '@angular/fire/firestore';\r\nimport { Observable, of } from 'rxjs';\r\nimport { catchError, filter, map } from 'rxjs/operators';\r\n\r\nexport interface FirestoreResponse<T> {\r\n    success: boolean;\r\n    data: any;\r\n    error: unknown;\r\n}\r\n\r\n@Injectable({\r\n    providedIn: 'root'\r\n})\r\n\r\nexport class FirestoreDataService {\r\n\r\n    private readonly firestore = inject(Firestore);\r\n    private readonly injector = inject(Injector);\r\n\r\n    /**\r\n     * Listen realtime document changes\r\n     */\r\n    public listenToDocument<T>(pathSegments: string[]): Observable<FirestoreResponse<T>> {\r\n        const documentRef = doc(this.firestore, pathSegments[0], ...pathSegments.slice(1));\r\n        return runInInjectionContext(this.injector, () => docData(documentRef)).pipe(\r\n            // Cast the response to the expected type\r\n            filter((response) => response != null),\r\n            // Return the response\r\n            map((response) => ({ success: true, data: response, error: null })),\r\n            // Handle errors\r\n            catchError((error: unknown) => {\r\n                console.error('[Firestore Document Listener Error]', error);\r\n                return of({ success: false, data: null, error });\r\n            })\r\n\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Listen realtime collection changes\r\n     */\r\n    public listenToCollection<T>(collectionPath: string[]): Observable<FirestoreResponse<T[]>> {\r\n        const collectionRef = collection(this.firestore, collectionPath[0], ...collectionPath.slice(1));\r\n        return runInInjectionContext(this.injector, () => collectionChanges(collectionRef)).pipe(\r\n            // Cast the response to the expected type\r\n            map((response) => ({ success: true, data: response, error: null })),\r\n            // Handle errors\r\n            catchError((error: unknown) => {\r\n                console.error('[Firestore Collection Listener Error]', error);\r\n                return of({ success: false, data: null, error });\r\n            })\r\n        );\r\n    }\r\n}","export class FirestorePaths {\r\n\r\n    public static readonly CLIENTS_COLLECTION = 'clients';\r\n    public static readonly BATCH_JOBS_COLLECTION = 'batchJobs';\r\n\r\n    public static getBatchJobDocumentPath(clientId: string, batchJobDocumentId: string): string[] {\r\n        return [\r\n            FirestorePaths.CLIENTS_COLLECTION,\r\n            clientId,\r\n            FirestorePaths.BATCH_JOBS_COLLECTION,\r\n            batchJobDocumentId\r\n        ];\r\n    }\r\n\r\n    public static getBatchJobCollectionPath(clientId: string): string[] {\r\n        return [\r\n            FirestorePaths.CLIENTS_COLLECTION,\r\n            clientId,\r\n            FirestorePaths.BATCH_JOBS_COLLECTION\r\n        ];\r\n    }\r\n\r\n}\r\n","import { EnvironmentProviders, makeEnvironmentProviders } from '@angular/core';\r\nimport { initializeApp, provideFirebaseApp } from '@angular/fire/app';\r\nimport { getFirestore, provideFirestore } from '@angular/fire/firestore';\r\n\r\n/**\r\n * Custom library provider that configures and initializes Firebase and Firestore \r\n * behind the scenes for the consuming application.\r\n */\r\nexport function provideFirestoreKit(firebaseConfig: any): EnvironmentProviders {\r\n    return makeEnvironmentProviders([\r\n        // The library handles the Angular Fire initialization boilerplate internally\r\n        provideFirebaseApp(() => initializeApp(firebaseConfig)),\r\n        provideFirestore(() => getFirestore())\r\n    ]);\r\n}","/*\r\n * Public API Surface of ngx-firestore-kit\r\n */\r\n\r\nexport * from './lib/ngx-firestore-kit';\r\nexport * from './lib/service/firestore-data.service';\r\nexport * from './lib/service/firestore-paths';\r\nexport * from './lib/service/firestore-providers';","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/fesm2022/goc-ngx-firestore-wrapper-kit.mjs

@@ -0,0 +1,109 @@
+import * as i0 from '@angular/core';
+import { Component, inject, Injector, runInInjectionContext, Injectable, makeEnvironmentProviders } from '@angular/core';
+import { Firestore, doc, docData, collection, collectionChanges, provideFirestore, getFirestore } from '@angular/fire/firestore';
+import { of } from 'rxjs';
+import { filter, map, catchError } from 'rxjs/operators';
+import { provideFirebaseApp, initializeApp } from '@angular/fire/app';
+
+class NgxFirestoreKit {
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: NgxFirestoreKit, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.23", type: NgxFirestoreKit, isStandalone: true, selector: "lib-ngx-firestore-kit", ngImport: i0, template: `
+    <p>
+      ngx-firestore-kit works!
+    </p>
+  `, isInline: true, styles: [""] });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: NgxFirestoreKit, decorators: [{
+            type: Component,
+            args: [{ selector: 'lib-ngx-firestore-kit', imports: [], template: `
+    <p>
+      ngx-firestore-kit works!
+    </p>
+  ` }]
+        }] });
+
+class FirestoreDataService {
+    firestore = inject(Firestore);
+    injector = inject(Injector);
+    /**
+     * Listen realtime document changes
+     */
+    listenToDocument(pathSegments) {
+        const documentRef = doc(this.firestore, pathSegments[0], ...pathSegments.slice(1));
+        return runInInjectionContext(this.injector, () => docData(documentRef)).pipe(
+        // Cast the response to the expected type
+        filter((response) => response != null), 
+        // Return the response
+        map((response) => ({ success: true, data: response, error: null })), 
+        // Handle errors
+        catchError((error) => {
+            console.error('[Firestore Document Listener Error]', error);
+            return of({ success: false, data: null, error });
+        }));
+    }
+    /**
+     * Listen realtime collection changes
+     */
+    listenToCollection(collectionPath) {
+        const collectionRef = collection(this.firestore, collectionPath[0], ...collectionPath.slice(1));
+        return runInInjectionContext(this.injector, () => collectionChanges(collectionRef)).pipe(
+        // Cast the response to the expected type
+        map((response) => ({ success: true, data: response, error: null })), 
+        // Handle errors
+        catchError((error) => {
+            console.error('[Firestore Collection Listener Error]', error);
+            return of({ success: false, data: null, error });
+        }));
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: FirestoreDataService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: FirestoreDataService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: FirestoreDataService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root'
+                }]
+        }] });
+
+class FirestorePaths {
+    static CLIENTS_COLLECTION = 'clients';
+    static BATCH_JOBS_COLLECTION = 'batchJobs';
+    static getBatchJobDocumentPath(clientId, batchJobDocumentId) {
+        return [
+            FirestorePaths.CLIENTS_COLLECTION,
+            clientId,
+            FirestorePaths.BATCH_JOBS_COLLECTION,
+            batchJobDocumentId
+        ];
+    }
+    static getBatchJobCollectionPath(clientId) {
+        return [
+            FirestorePaths.CLIENTS_COLLECTION,
+            clientId,
+            FirestorePaths.BATCH_JOBS_COLLECTION
+        ];
+    }
+}
+
+/**
+ * Custom library provider that configures and initializes Firebase and Firestore
+ * behind the scenes for the consuming application.
+ */
+function provideFirestoreKit(firebaseConfig) {
+    return makeEnvironmentProviders([
+        // The library handles the Angular Fire initialization boilerplate internally
+        provideFirebaseApp(() => initializeApp(firebaseConfig)),
+        provideFirestore(() => getFirestore())
+    ]);
+}
+
+/*
+ * Public API Surface of ngx-firestore-kit
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { FirestoreDataService, FirestorePaths, NgxFirestoreKit, provideFirestoreKit };
+//# sourceMappingURL=goc-ngx-firestore-wrapper-kit.mjs.map

package/fesm2022/goc-ngx-firestore-wrapper-kit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"goc-ngx-firestore-wrapper-kit.mjs","sources":["../../../projects/ngx-firestore-kit/src/lib/ngx-firestore-kit.ts","../../../projects/ngx-firestore-kit/src/lib/service/firestore-data.service.ts","../../../projects/ngx-firestore-kit/src/lib/service/firestore-paths.ts","../../../projects/ngx-firestore-kit/src/lib/service/firestore-providers.ts","../../../projects/ngx-firestore-kit/src/public-api.ts","../../../projects/ngx-firestore-kit/src/goc-ngx-firestore-wrapper-kit.ts"],"sourcesContent":["import { Component } from '@angular/core';\r\n\r\n@Component({\r\n  selector: 'lib-ngx-firestore-kit',\r\n  imports: [],\r\n  template: `\r\n    <p>\r\n      ngx-firestore-kit works!\r\n    </p>\r\n  `,\r\n  styles: ``,\r\n})\r\nexport class NgxFirestoreKit {\r\n\r\n}\r\n","import { Injectable, Injector, inject, runInInjectionContext } from '@angular/core';\r\nimport { Firestore, collection, collectionChanges, doc, docData } from '@angular/fire/firestore';\r\nimport { Observable, of } from 'rxjs';\r\nimport { catchError, filter, map } from 'rxjs/operators';\r\n\r\nexport interface FirestoreResponse<T> {\r\n    success: boolean;\r\n    data: any;\r\n    error: unknown;\r\n}\r\n\r\n@Injectable({\r\n    providedIn: 'root'\r\n})\r\n\r\nexport class FirestoreDataService {\r\n\r\n    private readonly firestore = inject(Firestore);\r\n    private readonly injector = inject(Injector);\r\n\r\n    /**\r\n     * Listen realtime document changes\r\n     */\r\n    public listenToDocument<T>(pathSegments: string[]): Observable<FirestoreResponse<T>> {\r\n        const documentRef = doc(this.firestore, pathSegments[0], ...pathSegments.slice(1));\r\n        return runInInjectionContext(this.injector, () => docData(documentRef)).pipe(\r\n            // Cast the response to the expected type\r\n            filter((response) => response != null),\r\n            // Return the response\r\n            map((response) => ({ success: true, data: response, error: null })),\r\n            // Handle errors\r\n            catchError((error: unknown) => {\r\n                console.error('[Firestore Document Listener Error]', error);\r\n                return of({ success: false, data: null, error });\r\n            })\r\n\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Listen realtime collection changes\r\n     */\r\n    public listenToCollection<T>(collectionPath: string[]): Observable<FirestoreResponse<T[]>> {\r\n        const collectionRef = collection(this.firestore, collectionPath[0], ...collectionPath.slice(1));\r\n        return runInInjectionContext(this.injector, () => collectionChanges(collectionRef)).pipe(\r\n            // Cast the response to the expected type\r\n            map((response) => ({ success: true, data: response, error: null })),\r\n            // Handle errors\r\n            catchError((error: unknown) => {\r\n                console.error('[Firestore Collection Listener Error]', error);\r\n                return of({ success: false, data: null, error });\r\n            })\r\n        );\r\n    }\r\n}","export class FirestorePaths {\r\n\r\n    public static readonly CLIENTS_COLLECTION = 'clients';\r\n    public static readonly BATCH_JOBS_COLLECTION = 'batchJobs';\r\n\r\n    public static getBatchJobDocumentPath(clientId: string, batchJobDocumentId: string): string[] {\r\n        return [\r\n            FirestorePaths.CLIENTS_COLLECTION,\r\n            clientId,\r\n            FirestorePaths.BATCH_JOBS_COLLECTION,\r\n            batchJobDocumentId\r\n        ];\r\n    }\r\n\r\n    public static getBatchJobCollectionPath(clientId: string): string[] {\r\n        return [\r\n            FirestorePaths.CLIENTS_COLLECTION,\r\n            clientId,\r\n            FirestorePaths.BATCH_JOBS_COLLECTION\r\n        ];\r\n    }\r\n\r\n}\r\n","import { EnvironmentProviders, makeEnvironmentProviders } from '@angular/core';\r\nimport { initializeApp, provideFirebaseApp } from '@angular/fire/app';\r\nimport { getFirestore, provideFirestore } from '@angular/fire/firestore';\r\n\r\n/**\r\n * Custom library provider that configures and initializes Firebase and Firestore \r\n * behind the scenes for the consuming application.\r\n */\r\nexport function provideFirestoreKit(firebaseConfig: any): EnvironmentProviders {\r\n    return makeEnvironmentProviders([\r\n        // The library handles the Angular Fire initialization boilerplate internally\r\n        provideFirebaseApp(() => initializeApp(firebaseConfig)),\r\n        provideFirestore(() => getFirestore())\r\n    ]);\r\n}","/*\r\n * Public API Surface of ngx-firestore-kit\r\n */\r\n\r\nexport * from './lib/ngx-firestore-kit';\r\nexport * from './lib/service/firestore-data.service';\r\nexport * from './lib/service/firestore-paths';\r\nexport * from './lib/service/firestore-providers';","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/fesm2022/ngx-firestore-kit.mjs

@@ -0,0 +1,109 @@
+import * as i0 from '@angular/core';
+import { Component, inject, Injector, runInInjectionContext, Injectable, makeEnvironmentProviders } from '@angular/core';
+import { Firestore, doc, docData, collection, collectionChanges, provideFirestore, getFirestore } from '@angular/fire/firestore';
+import { of } from 'rxjs';
+import { filter, map, catchError } from 'rxjs/operators';
+import { provideFirebaseApp, initializeApp } from '@angular/fire/app';
+
+class NgxFirestoreKit {
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: NgxFirestoreKit, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.23", type: NgxFirestoreKit, isStandalone: true, selector: "lib-ngx-firestore-kit", ngImport: i0, template: `
+    <p>
+      ngx-firestore-kit works!
+    </p>
+  `, isInline: true, styles: [""] });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: NgxFirestoreKit, decorators: [{
+            type: Component,
+            args: [{ selector: 'lib-ngx-firestore-kit', imports: [], template: `
+    <p>
+      ngx-firestore-kit works!
+    </p>
+  ` }]
+        }] });
+
+class FirestoreDataService {
+    firestore = inject(Firestore);
+    injector = inject(Injector);
+    /**
+     * Listen realtime document changes
+     */
+    listenToDocument(pathSegments) {
+        const documentRef = doc(this.firestore, pathSegments[0], ...pathSegments.slice(1));
+        return runInInjectionContext(this.injector, () => docData(documentRef)).pipe(
+        // Cast the response to the expected type
+        filter((response) => response != null), 
+        // Return the response
+        map((response) => ({ success: true, data: response, error: null })), 
+        // Handle errors
+        catchError((error) => {
+            console.error('[Firestore Document Listener Error]', error);
+            return of({ success: false, data: null, error });
+        }));
+    }
+    /**
+     * Listen realtime collection changes
+     */
+    listenToCollection(collectionPath) {
+        const collectionRef = collection(this.firestore, collectionPath[0], ...collectionPath.slice(1));
+        return runInInjectionContext(this.injector, () => collectionChanges(collectionRef)).pipe(
+        // Cast the response to the expected type
+        map((response) => ({ success: true, data: response, error: null })), 
+        // Handle errors
+        catchError((error) => {
+            console.error('[Firestore Collection Listener Error]', error);
+            return of({ success: false, data: null, error });
+        }));
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: FirestoreDataService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: FirestoreDataService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: FirestoreDataService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root'
+                }]
+        }] });
+
+class FirestorePaths {
+    static CLIENTS_COLLECTION = 'clients';
+    static BATCH_JOBS_COLLECTION = 'batchJobs';
+    static getBatchJobDocumentPath(clientId, batchJobDocumentId) {
+        return [
+            FirestorePaths.CLIENTS_COLLECTION,
+            clientId,
+            FirestorePaths.BATCH_JOBS_COLLECTION,
+            batchJobDocumentId
+        ];
+    }
+    static getBatchJobCollectionPath(clientId) {
+        return [
+            FirestorePaths.CLIENTS_COLLECTION,
+            clientId,
+            FirestorePaths.BATCH_JOBS_COLLECTION
+        ];
+    }
+}
+
+/**
+ * Custom library provider that configures and initializes Firebase and Firestore
+ * behind the scenes for the consuming application.
+ */
+function provideFirestoreKit(firebaseConfig) {
+    return makeEnvironmentProviders([
+        // The library handles the Angular Fire initialization boilerplate internally
+        provideFirebaseApp(() => initializeApp(firebaseConfig)),
+        provideFirestore(() => getFirestore())
+    ]);
+}
+
+/*
+ * Public API Surface of ngx-firestore-kit
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { FirestoreDataService, FirestorePaths, NgxFirestoreKit, provideFirestoreKit };
+//# sourceMappingURL=ngx-firestore-kit.mjs.map

package/fesm2022/ngx-firestore-kit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ngx-firestore-kit.mjs","sources":["../../../projects/ngx-firestore-kit/src/lib/ngx-firestore-kit.ts","../../../projects/ngx-firestore-kit/src/lib/service/firestore-data.service.ts","../../../projects/ngx-firestore-kit/src/lib/service/firestore-paths.ts","../../../projects/ngx-firestore-kit/src/lib/service/firestore-providers.ts","../../../projects/ngx-firestore-kit/src/public-api.ts","../../../projects/ngx-firestore-kit/src/ngx-firestore-kit.ts"],"sourcesContent":["import { Component } from '@angular/core';\r\n\r\n@Component({\r\n  selector: 'lib-ngx-firestore-kit',\r\n  imports: [],\r\n  template: `\r\n    <p>\r\n      ngx-firestore-kit works!\r\n    </p>\r\n  `,\r\n  styles: ``,\r\n})\r\nexport class NgxFirestoreKit {\r\n\r\n}\r\n","import { Injectable, Injector, inject, runInInjectionContext } from '@angular/core';\r\nimport { Firestore, collection, collectionChanges, doc, docData } from '@angular/fire/firestore';\r\nimport { Observable, of } from 'rxjs';\r\nimport { catchError, filter, map } from 'rxjs/operators';\r\n\r\nexport interface FirestoreResponse<T> {\r\n    success: boolean;\r\n    data: any;\r\n    error: unknown;\r\n}\r\n\r\n@Injectable({\r\n    providedIn: 'root'\r\n})\r\n\r\nexport class FirestoreDataService {\r\n\r\n    private readonly firestore = inject(Firestore);\r\n    private readonly injector = inject(Injector);\r\n\r\n    /**\r\n     * Listen realtime document changes\r\n     */\r\n    public listenToDocument<T>(pathSegments: string[]): Observable<FirestoreResponse<T>> {\r\n        const documentRef = doc(this.firestore, pathSegments[0], ...pathSegments.slice(1));\r\n        return runInInjectionContext(this.injector, () => docData(documentRef)).pipe(\r\n            // Cast the response to the expected type\r\n            filter((response) => response != null),\r\n            // Return the response\r\n            map((response) => ({ success: true, data: response, error: null })),\r\n            // Handle errors\r\n            catchError((error: unknown) => {\r\n                console.error('[Firestore Document Listener Error]', error);\r\n                return of({ success: false, data: null, error });\r\n            })\r\n\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Listen realtime collection changes\r\n     */\r\n    public listenToCollection<T>(collectionPath: string[]): Observable<FirestoreResponse<T[]>> {\r\n        const collectionRef = collection(this.firestore, collectionPath[0], ...collectionPath.slice(1));\r\n        return runInInjectionContext(this.injector, () => collectionChanges(collectionRef)).pipe(\r\n            // Cast the response to the expected type\r\n            map((response) => ({ success: true, data: response, error: null })),\r\n            // Handle errors\r\n            catchError((error: unknown) => {\r\n                console.error('[Firestore Collection Listener Error]', error);\r\n                return of({ success: false, data: null, error });\r\n            })\r\n        );\r\n    }\r\n}","export class FirestorePaths {\r\n\r\n    public static readonly CLIENTS_COLLECTION = 'clients';\r\n    public static readonly BATCH_JOBS_COLLECTION = 'batchJobs';\r\n\r\n    public static getBatchJobDocumentPath(clientId: string, batchJobDocumentId: string): string[] {\r\n        return [\r\n            FirestorePaths.CLIENTS_COLLECTION,\r\n            clientId,\r\n            FirestorePaths.BATCH_JOBS_COLLECTION,\r\n            batchJobDocumentId\r\n        ];\r\n    }\r\n\r\n    public static getBatchJobCollectionPath(clientId: string): string[] {\r\n        return [\r\n            FirestorePaths.CLIENTS_COLLECTION,\r\n            clientId,\r\n            FirestorePaths.BATCH_JOBS_COLLECTION\r\n        ];\r\n    }\r\n\r\n}\r\n","import { EnvironmentProviders, makeEnvironmentProviders } from '@angular/core';\r\nimport { initializeApp, provideFirebaseApp } from '@angular/fire/app';\r\nimport { getFirestore, provideFirestore } from '@angular/fire/firestore';\r\n\r\n/**\r\n * Custom library provider that configures and initializes Firebase and Firestore \r\n * behind the scenes for the consuming application.\r\n */\r\nexport function provideFirestoreKit(firebaseConfig: any): EnvironmentProviders {\r\n    return makeEnvironmentProviders([\r\n        // The library handles the Angular Fire initialization boilerplate internally\r\n        provideFirebaseApp(() => initializeApp(firebaseConfig)),\r\n        provideFirestore(() => getFirestore())\r\n    ]);\r\n}","/*\r\n * Public API Surface of ngx-firestore-kit\r\n */\r\n\r\nexport * from './lib/ngx-firestore-kit';\r\nexport * from './lib/service/firestore-data.service';\r\nexport * from './lib/service/firestore-paths';\r\nexport * from './lib/service/firestore-providers';","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/fesm2022/ngx-firestore-wrapper-kit.mjs

@@ -0,0 +1,109 @@
+import * as i0 from '@angular/core';
+import { Component, inject, Injector, runInInjectionContext, Injectable, makeEnvironmentProviders } from '@angular/core';
+import { Firestore, doc, docData, collection, collectionChanges, provideFirestore, getFirestore } from '@angular/fire/firestore';
+import { of } from 'rxjs';
+import { filter, map, catchError } from 'rxjs/operators';
+import { provideFirebaseApp, initializeApp } from '@angular/fire/app';
+
+class NgxFirestoreKit {
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: NgxFirestoreKit, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.23", type: NgxFirestoreKit, isStandalone: true, selector: "lib-ngx-firestore-kit", ngImport: i0, template: `
+    <p>
+      ngx-firestore-kit works!
+    </p>
+  `, isInline: true, styles: [""] });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: NgxFirestoreKit, decorators: [{
+            type: Component,
+            args: [{ selector: 'lib-ngx-firestore-kit', imports: [], template: `
+    <p>
+      ngx-firestore-kit works!
+    </p>
+  ` }]
+        }] });
+
+class FirestoreDataService {
+    firestore = inject(Firestore);
+    injector = inject(Injector);
+    /**
+     * Listen realtime document changes
+     */
+    listenToDocument(pathSegments) {
+        const documentRef = doc(this.firestore, pathSegments[0], ...pathSegments.slice(1));
+        return runInInjectionContext(this.injector, () => docData(documentRef)).pipe(
+        // Cast the response to the expected type
+        filter((response) => response != null), 
+        // Return the response
+        map((response) => ({ success: true, data: response, error: null })), 
+        // Handle errors
+        catchError((error) => {
+            console.error('[Firestore Document Listener Error]', error);
+            return of({ success: false, data: null, error });
+        }));
+    }
+    /**
+     * Listen realtime collection changes
+     */
+    listenToCollection(collectionPath) {
+        const collectionRef = collection(this.firestore, collectionPath[0], ...collectionPath.slice(1));
+        return runInInjectionContext(this.injector, () => collectionChanges(collectionRef)).pipe(
+        // Cast the response to the expected type
+        map((response) => ({ success: true, data: response, error: null })), 
+        // Handle errors
+        catchError((error) => {
+            console.error('[Firestore Collection Listener Error]', error);
+            return of({ success: false, data: null, error });
+        }));
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: FirestoreDataService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: FirestoreDataService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.23", ngImport: i0, type: FirestoreDataService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root'
+                }]
+        }] });
+
+class FirestorePaths {
+    static CLIENTS_COLLECTION = 'clients';
+    static BATCH_JOBS_COLLECTION = 'batchJobs';
+    static getBatchJobDocumentPath(clientId, batchJobDocumentId) {
+        return [
+            FirestorePaths.CLIENTS_COLLECTION,
+            clientId,
+            FirestorePaths.BATCH_JOBS_COLLECTION,
+            batchJobDocumentId
+        ];
+    }
+    static getBatchJobCollectionPath(clientId) {
+        return [
+            FirestorePaths.CLIENTS_COLLECTION,
+            clientId,
+            FirestorePaths.BATCH_JOBS_COLLECTION
+        ];
+    }
+}
+
+/**
+ * Custom library provider that configures and initializes Firebase and Firestore
+ * behind the scenes for the consuming application.
+ */
+function provideFirestoreKit(firebaseConfig) {
+    return makeEnvironmentProviders([
+        // The library handles the Angular Fire initialization boilerplate internally
+        provideFirebaseApp(() => initializeApp(firebaseConfig)),
+        provideFirestore(() => getFirestore())
+    ]);
+}
+
+/*
+ * Public API Surface of ngx-firestore-kit
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { FirestoreDataService, FirestorePaths, NgxFirestoreKit, provideFirestoreKit };
+//# sourceMappingURL=ngx-firestore-wrapper-kit.mjs.map

package/fesm2022/ngx-firestore-wrapper-kit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ngx-firestore-wrapper-kit.mjs","sources":["../../../projects/ngx-firestore-kit/src/lib/ngx-firestore-kit.ts","../../../projects/ngx-firestore-kit/src/lib/service/firestore-data.service.ts","../../../projects/ngx-firestore-kit/src/lib/service/firestore-paths.ts","../../../projects/ngx-firestore-kit/src/lib/service/firestore-providers.ts","../../../projects/ngx-firestore-kit/src/public-api.ts","../../../projects/ngx-firestore-kit/src/ngx-firestore-wrapper-kit.ts"],"sourcesContent":["import { Component } from '@angular/core';\r\n\r\n@Component({\r\n  selector: 'lib-ngx-firestore-kit',\r\n  imports: [],\r\n  template: `\r\n    <p>\r\n      ngx-firestore-kit works!\r\n    </p>\r\n  `,\r\n  styles: ``,\r\n})\r\nexport class NgxFirestoreKit {\r\n\r\n}\r\n","import { Injectable, Injector, inject, runInInjectionContext } from '@angular/core';\r\nimport { Firestore, collection, collectionChanges, doc, docData } from '@angular/fire/firestore';\r\nimport { Observable, of } from 'rxjs';\r\nimport { catchError, filter, map } from 'rxjs/operators';\r\n\r\nexport interface FirestoreResponse<T> {\r\n    success: boolean;\r\n    data: any;\r\n    error: unknown;\r\n}\r\n\r\n@Injectable({\r\n    providedIn: 'root'\r\n})\r\n\r\nexport class FirestoreDataService {\r\n\r\n    private readonly firestore = inject(Firestore);\r\n    private readonly injector = inject(Injector);\r\n\r\n    /**\r\n     * Listen realtime document changes\r\n     */\r\n    public listenToDocument<T>(pathSegments: string[]): Observable<FirestoreResponse<T>> {\r\n        const documentRef = doc(this.firestore, pathSegments[0], ...pathSegments.slice(1));\r\n        return runInInjectionContext(this.injector, () => docData(documentRef)).pipe(\r\n            // Cast the response to the expected type\r\n            filter((response) => response != null),\r\n            // Return the response\r\n            map((response) => ({ success: true, data: response, error: null })),\r\n            // Handle errors\r\n            catchError((error: unknown) => {\r\n                console.error('[Firestore Document Listener Error]', error);\r\n                return of({ success: false, data: null, error });\r\n            })\r\n\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Listen realtime collection changes\r\n     */\r\n    public listenToCollection<T>(collectionPath: string[]): Observable<FirestoreResponse<T[]>> {\r\n        const collectionRef = collection(this.firestore, collectionPath[0], ...collectionPath.slice(1));\r\n        return runInInjectionContext(this.injector, () => collectionChanges(collectionRef)).pipe(\r\n            // Cast the response to the expected type\r\n            map((response) => ({ success: true, data: response, error: null })),\r\n            // Handle errors\r\n            catchError((error: unknown) => {\r\n                console.error('[Firestore Collection Listener Error]', error);\r\n                return of({ success: false, data: null, error });\r\n            })\r\n        );\r\n    }\r\n}","export class FirestorePaths {\r\n\r\n    public static readonly CLIENTS_COLLECTION = 'clients';\r\n    public static readonly BATCH_JOBS_COLLECTION = 'batchJobs';\r\n\r\n    public static getBatchJobDocumentPath(clientId: string, batchJobDocumentId: string): string[] {\r\n        return [\r\n            FirestorePaths.CLIENTS_COLLECTION,\r\n            clientId,\r\n            FirestorePaths.BATCH_JOBS_COLLECTION,\r\n            batchJobDocumentId\r\n        ];\r\n    }\r\n\r\n    public static getBatchJobCollectionPath(clientId: string): string[] {\r\n        return [\r\n            FirestorePaths.CLIENTS_COLLECTION,\r\n            clientId,\r\n            FirestorePaths.BATCH_JOBS_COLLECTION\r\n        ];\r\n    }\r\n\r\n}\r\n","import { EnvironmentProviders, makeEnvironmentProviders } from '@angular/core';\r\nimport { initializeApp, provideFirebaseApp } from '@angular/fire/app';\r\nimport { getFirestore, provideFirestore } from '@angular/fire/firestore';\r\n\r\n/**\r\n * Custom library provider that configures and initializes Firebase and Firestore \r\n * behind the scenes for the consuming application.\r\n */\r\nexport function provideFirestoreKit(firebaseConfig: any): EnvironmentProviders {\r\n    return makeEnvironmentProviders([\r\n        // The library handles the Angular Fire initialization boilerplate internally\r\n        provideFirebaseApp(() => initializeApp(firebaseConfig)),\r\n        provideFirestore(() => getFirestore())\r\n    ]);\r\n}","/*\r\n * Public API Surface of ngx-firestore-kit\r\n */\r\n\r\nexport * from './lib/ngx-firestore-kit';\r\nexport * from './lib/service/firestore-data.service';\r\nexport * from './lib/service/firestore-paths';\r\nexport * from './lib/service/firestore-providers';","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -0,0 +1,44 @@
+import * as i0 from '@angular/core';
+import { EnvironmentProviders } from '@angular/core';
+import { Observable } from 'rxjs';
+
+declare class NgxFirestoreKit {
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgxFirestoreKit, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NgxFirestoreKit, "lib-ngx-firestore-kit", never, {}, {}, never, never, true, never>;
+}
+
+interface FirestoreResponse<T> {
+    success: boolean;
+    data: any;
+    error: unknown;
+}
+declare class FirestoreDataService {
+    private readonly firestore;
+    private readonly injector;
+    /**
+     * Listen realtime document changes
+     */
+    listenToDocument<T>(pathSegments: string[]): Observable<FirestoreResponse<T>>;
+    /**
+     * Listen realtime collection changes
+     */
+    listenToCollection<T>(collectionPath: string[]): Observable<FirestoreResponse<T[]>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FirestoreDataService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<FirestoreDataService>;
+}
+
+declare class FirestorePaths {
+    static readonly CLIENTS_COLLECTION = "clients";
+    static readonly BATCH_JOBS_COLLECTION = "batchJobs";
+    static getBatchJobDocumentPath(clientId: string, batchJobDocumentId: string): string[];
+    static getBatchJobCollectionPath(clientId: string): string[];
+}
+
+/**
+ * Custom library provider that configures and initializes Firebase and Firestore
+ * behind the scenes for the consuming application.
+ */
+declare function provideFirestoreKit(firebaseConfig: any): EnvironmentProviders;
+
+export { FirestoreDataService, FirestorePaths, NgxFirestoreKit, provideFirestoreKit };
+export type { FirestoreResponse };

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "ngx-firestore-wrapper-kit",
+  "version": "0.0.1",
+  "peerDependencies": {
+    "@angular/common": "^20.3.0",
+    "@angular/core": "^20.3.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/ngx-firestore-wrapper-kit.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/ngx-firestore-wrapper-kit.mjs"
+    }
+  }
+}