@progalaxyelabs/ngx-stonescriptphp-client 1.18.3 → 1.19.0

package/fesm2022/progalaxyelabs-ngx-stonescriptphp-client.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, makeEnvironmentProviders, Injectable, Inject, EventEmitter, Output, Input, Component, Optional } from '@angular/core';
+import { InjectionToken, makeEnvironmentProviders, Injectable, Inject, Optional, EventEmitter, Output, Input, Component } from '@angular/core';
 import { BehaviorSubject } from 'rxjs';
 import * as i3 from '@angular/common';
 import { CommonModule } from '@angular/common';
@@ -8,6 +8,13 @@ import { FormsModule } from '@angular/forms';
 
 class MyEnvironmentModel {
     production = true;
+    /**
+     * Enable debug logging across the app.
+     * Set to true in development environments to see [DEBUG] logs in the browser console.
+     * Always false in production.
+     * @default false
+     */
+    debug = false;
     /**
      * Platform code identifier (e.g., 'progalaxy', 'hr', 'admin').
      * Used for multi-tenant authentication.
@@ -1448,6 +1455,61 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
                 }]
         }], ctorParameters: () => [] });
 
+/**
+ * LogService — debug logger for ProgalaxyELabs Angular platforms.
+ *
+ * Reads environment.debug from MyEnvironmentModel (set via provideNgxStoneScriptPhpClient).
+ * All output is silenced when debug = false (production default).
+ *
+ * Usage in components / services:
+ * ```typescript
+ * constructor(private log: LogService) {}
+ *
+ * this.log.debug('MyComponent', 'event fired', { data });
+ * ```
+ *
+ * Configure in app:
+ * ```typescript
+ * // environment.ts
+ * export const environment = { production: false, debug: true, ... };
+ *
+ * // app.config.ts
+ * provideNgxStoneScriptPhpClient(environment)  // LogService picks up environment.debug automatically
+ * ```
+ */
+class LogService {
+    _debug = false;
+    constructor(env) {
+        this._debug = env?.debug ?? false;
+    }
+    /** Log a debug message. No-op when environment.debug = false. */
+    debug(context, message, ...args) {
+        if (this._debug) {
+            console.log(`[DEBUG][${context}] ${message}`, ...args);
+        }
+    }
+    /** Log a warning. Always visible regardless of debug flag. */
+    warn(context, message, ...args) {
+        console.warn(`[WARN][${context}] ${message}`, ...args);
+    }
+    /** Log an error. Always visible regardless of debug flag. */
+    error(context, message, ...args) {
+        console.error(`[ERROR][${context}] ${message}`, ...args);
+    }
+    /** Returns true if debug mode is on (useful for conditional expensive logging). */
+    get isDebug() {
+        return this._debug;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: LogService, deps: [{ token: MyEnvironmentModel, optional: true }], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: LogService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: LogService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [{ type: MyEnvironmentModel, decorators: [{
+                    type: Optional
+                }] }] });
+
 /**
  * CSRF Token Service
  *
@@ -4221,5 +4283,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-export { AUTH_PLUGIN, ApiConnectionService, ApiResponse, AuthPageComponent, AuthService, CsrfService, DbService, FilesService, LoginDialogComponent, MyEnvironmentModel, ProgalaxyElabsAuth, ProviderRegistryService, RegisterComponent, SigninStatusService, StoneScriptPHPAuth, TenantLoginComponent, TenantLoginDialogComponent, TenantRegisterComponent, TenantRegisterDialogComponent, TokenService, VerifyStatus, provideNgxStoneScriptPhpClient };
+export { AUTH_PLUGIN, ApiConnectionService, ApiResponse, AuthPageComponent, AuthService, CsrfService, DbService, FilesService, LogService, LoginDialogComponent, MyEnvironmentModel, ProgalaxyElabsAuth, ProviderRegistryService, RegisterComponent, SigninStatusService, StoneScriptPHPAuth, TenantLoginComponent, TenantLoginDialogComponent, TenantRegisterComponent, TenantRegisterDialogComponent, TokenService, VerifyStatus, provideNgxStoneScriptPhpClient };
 //# sourceMappingURL=progalaxyelabs-ngx-stonescriptphp-client.mjs.map