joopjs 2.0.0

package/dist/analytics/index.mjs

@@ -0,0 +1,136 @@
+// src/events/index.ts
+var JoopSubject = class {
+  _listeners = [];
+  subscribe(listener) {
+    this._listeners.push(listener);
+    return () => {
+      this._listeners = this._listeners.filter((l) => l !== listener);
+    };
+  }
+  next(value) {
+    for (const listener of this._listeners) {
+      listener(value);
+    }
+  }
+  asObservable() {
+    return new JoopObservable((listener) => this.subscribe(listener));
+  }
+};
+var JoopObservable = class {
+  constructor(_subscribeFn) {
+    this._subscribeFn = _subscribeFn;
+  }
+  _subscribeFn;
+  subscribe(listener) {
+    return this._subscribeFn(listener);
+  }
+  /** Returns the current value without subscribing (only meaningful for BehaviorSubject-backed observables). */
+  getOnce() {
+    let result;
+    const unsub = this.subscribe((v) => {
+      result = v;
+    });
+    unsub();
+    return result;
+  }
+};
+
+// src/analytics/analytics.service.ts
+var JoopAnalyticsService = class {
+  _adapters = [];
+  _context = {};
+  _userId = "";
+  _sessionId = "";
+  _event$ = new JoopSubject();
+  _queue = [];
+  _enabled = true;
+  addAdapter(adapter) {
+    if (!this._adapters.find((a) => a.name === adapter.name)) {
+      this._adapters.push(adapter);
+      for (const ev of this._queue) adapter.track?.(ev);
+    }
+  }
+  removeAdapter(name) {
+    this._adapters = this._adapters.filter((a) => a.name !== name);
+  }
+  enable() {
+    this._enabled = true;
+  }
+  disable() {
+    this._enabled = false;
+  }
+  setContext(ctx) {
+    this._context = { ...this._context, ...ctx };
+  }
+  setUser(userId, traits) {
+    this._userId = userId;
+    this._adapters.forEach((a) => a.identify?.(userId, traits));
+  }
+  setSession(sessionId) {
+    this._sessionId = sessionId;
+  }
+  track(name, properties) {
+    if (!this._enabled) return;
+    const event = {
+      name,
+      properties: { ...this._context, ...properties },
+      timestamp: Date.now(),
+      userId: this._userId || void 0,
+      sessionId: this._sessionId || void 0
+    };
+    this._event$.next(event);
+    if (this._adapters.length === 0) {
+      this._queue.push(event);
+      return;
+    }
+    this._adapters.forEach((a) => {
+      try {
+        a.track?.(event);
+      } catch {
+      }
+    });
+  }
+  page(name, properties) {
+    if (!this._enabled) return;
+    const merged = { ...this._context, ...properties };
+    this._adapters.forEach((a) => {
+      try {
+        a.page?.(name, merged);
+      } catch {
+      }
+    });
+    this.track(`page:${name}`, merged);
+  }
+  identify(userId, traits) {
+    this.setUser(userId, traits);
+  }
+  /** Subscribe to all tracked events (useful for debugging) */
+  events$() {
+    return this._event$.asObservable();
+  }
+  /** Flush the pre-adapter queue (e.g. after lazy-loading analytics) */
+  flush() {
+    for (const ev of this._queue) {
+      this._adapters.forEach((a) => {
+        try {
+          a.track?.(ev);
+        } catch {
+        }
+      });
+    }
+    this._queue = [];
+  }
+  getQueueSize() {
+    return this._queue.length;
+  }
+};
+var consoleAnalyticsAdapter = {
+  name: "console",
+  track: (e) => console.log(`[analytics:track] ${e.name}`, e.properties),
+  page: (name) => console.log(`[analytics:page] ${name}`),
+  identify: (id) => console.log(`[analytics:identify] ${id}`)
+};
+
+export { JoopAnalyticsService, consoleAnalyticsAdapter };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/analytics/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/events/index.ts","../../src/analytics/analytics.service.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["export type Unsubscribe = () => void;\nexport type Listener<T> = (value: T) => void;\n\n/**\n * Lightweight pub/sub subject — emits to all current subscribers.\n * Replaces RxJS Subject without pulling in the full RxJS dependency.\n */\nexport class JoopSubject<T> {\n  private _listeners: Listener<T>[] = [];\n\n  subscribe(listener: Listener<T>): Unsubscribe {\n    this._listeners.push(listener);\n    return () => {\n      this._listeners = this._listeners.filter(l => l !== listener);\n    };\n  }\n\n  next(value: T): void {\n    for (const listener of this._listeners) {\n      listener(value);\n    }\n  }\n\n  asObservable(): JoopObservable<T> {\n    return new JoopObservable<T>(listener => this.subscribe(listener));\n  }\n}\n\n/**\n * Stateful subject — replays the current value to any new subscriber immediately.\n * Replaces RxJS BehaviorSubject.\n */\nexport class JoopBehaviorSubject<T> extends JoopSubject<T> {\n  private _value: T;\n\n  constructor(initialValue: T) {\n    super();\n    this._value = initialValue;\n  }\n\n  getValue(): T {\n    return this._value;\n  }\n\n  override next(value: T): void {\n    this._value = value;\n    super.next(value);\n  }\n\n  override subscribe(listener: Listener<T>): Unsubscribe {\n    listener(this._value);\n    return super.subscribe(listener);\n  }\n\n  override asObservable(): JoopObservable<T> {\n    return new JoopObservable<T>(listener => this.subscribe(listener));\n  }\n}\n\n/**\n * Read-only observable handle returned from asObservable().\n */\nexport class JoopObservable<T> {\n  constructor(private _subscribeFn: (listener: Listener<T>) => Unsubscribe) {}\n\n  subscribe(listener: Listener<T>): Unsubscribe {\n    return this._subscribeFn(listener);\n  }\n\n  /** Returns the current value without subscribing (only meaningful for BehaviorSubject-backed observables). */\n  getOnce(): T | undefined {\n    let result: T | undefined;\n    const unsub = this.subscribe(v => { result = v; });\n    unsub();\n    return result;\n  }\n}\n","import { JoopSubject } from '../events';\n\nexport interface JoopAnalyticsEvent {\n  name: string;\n  properties?: Record<string, unknown>;\n  timestamp: number;\n  sessionId?: string;\n  userId?: string;\n}\n\nexport interface JoopAnalyticsAdapter {\n  name: string;\n  track?(event: JoopAnalyticsEvent): void;\n  page?(name: string, properties?: Record<string, unknown>): void;\n  identify?(userId: string, traits?: Record<string, unknown>): void;\n}\n\nexport class JoopAnalyticsService {\n  private _adapters: JoopAnalyticsAdapter[] = [];\n  private _context: Record<string, unknown> = {};\n  private _userId = '';\n  private _sessionId = '';\n  private _event$ = new JoopSubject<JoopAnalyticsEvent>();\n  private _queue: JoopAnalyticsEvent[] = [];\n  private _enabled = true;\n\n  addAdapter(adapter: JoopAnalyticsAdapter): void {\n    if (!this._adapters.find(a => a.name === adapter.name)) {\n      this._adapters.push(adapter);\n      // drain queued events to new adapter\n      for (const ev of this._queue) adapter.track?.(ev);\n    }\n  }\n\n  removeAdapter(name: string): void {\n    this._adapters = this._adapters.filter(a => a.name !== name);\n  }\n\n  enable(): void { this._enabled = true; }\n  disable(): void { this._enabled = false; }\n\n  setContext(ctx: Record<string, unknown>): void {\n    this._context = { ...this._context, ...ctx };\n  }\n\n  setUser(userId: string, traits?: Record<string, unknown>): void {\n    this._userId = userId;\n    this._adapters.forEach(a => a.identify?.(userId, traits));\n  }\n\n  setSession(sessionId: string): void { this._sessionId = sessionId; }\n\n  track(name: string, properties?: Record<string, unknown>): void {\n    if (!this._enabled) return;\n    const event: JoopAnalyticsEvent = {\n      name,\n      properties: { ...this._context, ...properties },\n      timestamp: Date.now(),\n      userId: this._userId || undefined,\n      sessionId: this._sessionId || undefined,\n    };\n    this._event$.next(event);\n    if (this._adapters.length === 0) { this._queue.push(event); return; }\n    this._adapters.forEach(a => { try { a.track?.(event); } catch { /* isolate adapter errors */ } });\n  }\n\n  page(name: string, properties?: Record<string, unknown>): void {\n    if (!this._enabled) return;\n    const merged = { ...this._context, ...properties };\n    this._adapters.forEach(a => { try { a.page?.(name, merged); } catch { /* */ } });\n    this.track(`page:${name}`, merged);\n  }\n\n  identify(userId: string, traits?: Record<string, unknown>): void {\n    this.setUser(userId, traits);\n  }\n\n  /** Subscribe to all tracked events (useful for debugging) */\n  events$() { return this._event$.asObservable(); }\n\n  /** Flush the pre-adapter queue (e.g. after lazy-loading analytics) */\n  flush(): void {\n    for (const ev of this._queue) {\n      this._adapters.forEach(a => { try { a.track?.(ev); } catch { /* */ } });\n    }\n    this._queue = [];\n  }\n\n  getQueueSize(): number { return this._queue.length; }\n}\n\n// ── Built-in console adapter (for development) ────────────────────────────\nexport const consoleAnalyticsAdapter: JoopAnalyticsAdapter = {\n  name: 'console',\n  track: (e) => console.log(`[analytics:track] ${e.name}`, e.properties),\n  page: (name) => console.log(`[analytics:page] ${name}`),\n  identify: (id) => console.log(`[analytics:identify] ${id}`),\n};\n"]}

package/dist/angular/index.d.mts

@@ -0,0 +1,148 @@
+import { J as JoopInstance } from '../joop-Bx7Iwj5p.mjs';
+import { J as JoopObservable } from '../index-Dz0gOur2.mjs';
+import '../config.service-Cz4QQLlf.mjs';
+import '../config.models-Cqg04fAQ.mjs';
+import '../index-B_ksKpS1.mjs';
+import '../data-storage.service-LvhGRCmw.mjs';
+import '../index-CqDKWTUP.mjs';
+import '../auth.service-DNVB-L4U.mjs';
+import '../oidc-client-DIJcClmB.mjs';
+import '../adapters-B6slG6hQ.mjs';
+import '../client-profile.service-BuPeXVp5.mjs';
+import '../idempotency.service-_6LqhivP.mjs';
+import '../aes.service-CkoupAww.mjs';
+import '../encryption/index.mjs';
+import '../crypto-utils-DriNhLdx.mjs';
+import '../session/index.mjs';
+import '../observability/index.mjs';
+import '../network-monitor-BIwPSXme.mjs';
+import '../dev/index.mjs';
+import '../statement-parser-C2qNmb49.mjs';
+import '../theme/index.mjs';
+import '../i18n/index.mjs';
+import '../a11y.service-C-DQQfgO.mjs';
+import '../native-bridge/index.mjs';
+import '../deeplink.service-Ctd5u243.mjs';
+import '../cache/index.mjs';
+import '../network/index.mjs';
+import '../analytics/index.mjs';
+import '../form-validator-3tkmzr_o.mjs';
+import '../watermark.service-QNegMeQZ.mjs';
+import '../storage/index.mjs';
+import '../forms/index.mjs';
+import '../notification.service-Dm4fvfZf.mjs';
+import '../router/index.mjs';
+import '../pwa/index.mjs';
+import '../ai/index.mjs';
+import '../differential-privacy-BcAv1G80.mjs';
+import '../workers/index.mjs';
+import '../state/index.mjs';
+import '../sync-engine-DZqyKHkK.mjs';
+import '../workflow/index.mjs';
+
+/**
+ * joopjs/angular — Angular integration
+ *
+ * @angular/core 17+ is a required peer dependency.
+ *
+ * Standalone (recommended):
+ *   bootstrapApplication(AppComponent, {
+ *     providers: [provideJoop(joopInstance)]
+ *   });
+ *
+ * NgModule (legacy):
+ *   @NgModule({ imports: [JoopModule.forRoot(joopInstance)] })
+ *
+ * Inject anywhere:
+ *   constructor(@Inject(JOOP) private joop: JoopInstance) {}
+ *
+ * RxJS bridge:
+ *   readonly theme$ = fromJoop(this.joop.theme.active$());
+ */
+
+/**
+ * InjectionToken for the JoopInstance.
+ * Angular's DI accepts any object as a token — use this with @Inject(JOOP).
+ *
+ * Example with @angular/core InjectionToken (recommended):
+ *   import { InjectionToken } from '@angular/core';
+ *   const JOOP = new InjectionToken<JoopInstance>('JoopInstance');
+ *
+ * The string form below works for both class-based and object-literal tokens.
+ */
+declare const JOOP: "JOOP_INSTANCE";
+declare const JOOP_AUTH: "JOOP_AUTH";
+declare const JOOP_THEME: "JOOP_THEME";
+declare const JOOP_I18N: "JOOP_I18N";
+declare const JOOP_HTTP: "JOOP_HTTP";
+declare const JOOP_LOADER: "JOOP_LOADER";
+declare const JOOP_ALERT: "JOOP_ALERT";
+declare const JOOP_ROUTER: "JOOP_ROUTER";
+declare const JOOP_ANALYTICS: "JOOP_ANALYTICS";
+declare const JOOP_FEATURE_FLAGS: "JOOP_FEATURE_FLAGS";
+declare const JOOP_AUDIT_LOG: "JOOP_AUDIT_LOG";
+declare const JOOP_STORE: "JOOP_STORE";
+declare const JOOP_KEY_VAULT: "JOOP_KEY_VAULT";
+declare const JOOP_NETWORK: "JOOP_NETWORK";
+declare const JOOP_LIFECYCLE: "JOOP_LIFECYCLE";
+interface JoopProvider {
+    provide: string;
+    useValue: unknown;
+}
+/**
+ * Returns an array of Angular providers for the JoopInstance and its services.
+ * Use with bootstrapApplication() or provideEnvironmentInitializer().
+ *
+ *   providers: [...provideJoop(await createJoop(config))]
+ */
+declare function provideJoop(instance: JoopInstance): JoopProvider[];
+/**
+ * Minimal NgModule descriptor for use with @NgModule imports.
+ * Call JoopModule.forRoot(instance) and spread the result into the imports array.
+ *
+ *   @NgModule({ imports: [...JoopModule.forRoot(instance).providers ?? []] })
+ *
+ * For proper Angular NgModule integration, use the returned providers array
+ * directly in your app's providers:
+ *
+ *   @NgModule({ providers: JoopModule.forRoot(instance) })
+ */
+declare const JoopModule: {
+    readonly forRoot: (instance: JoopInstance) => {
+        providers: JoopProvider[];
+    };
+};
+/**
+ * Converts a JoopObservable (JoopBehaviorSubject) into an RxJS-compatible
+ * Observable. The returned object implements the Observable contract:
+ * subscribe(observer) returns a Subscription with unsubscribe().
+ *
+ *   readonly loading$ = fromJoop(this.joop.loader.isLoading$());
+ *   readonly theme$   = fromJoop(this.joop.theme.active$());
+ */
+declare function fromJoop<T>(joopObs: JoopObservable<T>): RxJSLike<T>;
+/**
+ * Converts an RxJS Observable into a JoopObservable-compatible object.
+ * Useful for bridging existing RxJS streams into JoopJS services.
+ */
+declare function toJoop<T>(rxjsObs: RxJSLike<T>): JoopObservable<T>;
+interface RxJSLike<T> {
+    subscribe(observerOrNext: ((value: T) => void) | {
+        next?: (v: T) => void;
+        error?: (e: unknown) => void;
+        complete?: () => void;
+    }): {
+        unsubscribe(): void;
+    };
+    pipe(...operators: Array<(obs: RxJSLike<T>) => RxJSLike<unknown>>): RxJSLike<unknown>;
+}
+/**
+ * Returns a factory for wrapping JoopObservable subscriptions inside Angular's
+ * change detection zone. Pass NgZone.run as the runner.
+ *
+ *   const zonedFromJoop = createZonedFromJoop(zone.run.bind(zone));
+ *   readonly theme$ = zonedFromJoop(this.joop.theme.active$());
+ */
+declare function createZonedFromJoop(zoneRun: <T>(fn: () => T) => T): <T>(obs: JoopObservable<T>) => RxJSLike<T>;
+
+export { JOOP, JOOP_ALERT, JOOP_ANALYTICS, JOOP_AUDIT_LOG, JOOP_AUTH, JOOP_FEATURE_FLAGS, JOOP_HTTP, JOOP_I18N, JOOP_KEY_VAULT, JOOP_LIFECYCLE, JOOP_LOADER, JOOP_NETWORK, JOOP_ROUTER, JOOP_STORE, JOOP_THEME, JoopModule, type JoopProvider, type RxJSLike, createZonedFromJoop, fromJoop, provideJoop, toJoop };

package/dist/angular/index.d.ts

@@ -0,0 +1,148 @@
+import { J as JoopInstance } from '../joop-CA3DMeOO.js';
+import { J as JoopObservable } from '../index-Dz0gOur2.js';
+import '../config.service-CrCvI-JS.js';
+import '../config.models-Cqg04fAQ.js';
+import '../index-DFqEoX_l.js';
+import '../data-storage.service-DT6xaTxE.js';
+import '../index-CqDKWTUP.js';
+import '../auth.service-PjUUSUIt.js';
+import '../oidc-client-DxhyE59t.js';
+import '../adapters-B6slG6hQ.js';
+import '../client-profile.service-D5bRRYQp.js';
+import '../idempotency.service-eOKoISRD.js';
+import '../aes.service-CkoupAww.js';
+import '../encryption/index.js';
+import '../crypto-utils-DriNhLdx.js';
+import '../session/index.js';
+import '../observability/index.js';
+import '../network-monitor-Bqp2hvZr.js';
+import '../dev/index.js';
+import '../statement-parser-BHQtXwCM.js';
+import '../theme/index.js';
+import '../i18n/index.js';
+import '../a11y.service-CauEJrJe.js';
+import '../native-bridge/index.js';
+import '../deeplink.service-uUuTnY9_.js';
+import '../cache/index.js';
+import '../network/index.js';
+import '../analytics/index.js';
+import '../form-validator-3tkmzr_o.js';
+import '../watermark.service-Detur5tq.js';
+import '../storage/index.js';
+import '../forms/index.js';
+import '../notification.service-tEMKatWJ.js';
+import '../router/index.js';
+import '../pwa/index.js';
+import '../ai/index.js';
+import '../differential-privacy-C8mAUjZr.js';
+import '../workers/index.js';
+import '../state/index.js';
+import '../sync-engine-DCIMRG5s.js';
+import '../workflow/index.js';
+
+/**
+ * joopjs/angular — Angular integration
+ *
+ * @angular/core 17+ is a required peer dependency.
+ *
+ * Standalone (recommended):
+ *   bootstrapApplication(AppComponent, {
+ *     providers: [provideJoop(joopInstance)]
+ *   });
+ *
+ * NgModule (legacy):
+ *   @NgModule({ imports: [JoopModule.forRoot(joopInstance)] })
+ *
+ * Inject anywhere:
+ *   constructor(@Inject(JOOP) private joop: JoopInstance) {}
+ *
+ * RxJS bridge:
+ *   readonly theme$ = fromJoop(this.joop.theme.active$());
+ */
+
+/**
+ * InjectionToken for the JoopInstance.
+ * Angular's DI accepts any object as a token — use this with @Inject(JOOP).
+ *
+ * Example with @angular/core InjectionToken (recommended):
+ *   import { InjectionToken } from '@angular/core';
+ *   const JOOP = new InjectionToken<JoopInstance>('JoopInstance');
+ *
+ * The string form below works for both class-based and object-literal tokens.
+ */
+declare const JOOP: "JOOP_INSTANCE";
+declare const JOOP_AUTH: "JOOP_AUTH";
+declare const JOOP_THEME: "JOOP_THEME";
+declare const JOOP_I18N: "JOOP_I18N";
+declare const JOOP_HTTP: "JOOP_HTTP";
+declare const JOOP_LOADER: "JOOP_LOADER";
+declare const JOOP_ALERT: "JOOP_ALERT";
+declare const JOOP_ROUTER: "JOOP_ROUTER";
+declare const JOOP_ANALYTICS: "JOOP_ANALYTICS";
+declare const JOOP_FEATURE_FLAGS: "JOOP_FEATURE_FLAGS";
+declare const JOOP_AUDIT_LOG: "JOOP_AUDIT_LOG";
+declare const JOOP_STORE: "JOOP_STORE";
+declare const JOOP_KEY_VAULT: "JOOP_KEY_VAULT";
+declare const JOOP_NETWORK: "JOOP_NETWORK";
+declare const JOOP_LIFECYCLE: "JOOP_LIFECYCLE";
+interface JoopProvider {
+    provide: string;
+    useValue: unknown;
+}
+/**
+ * Returns an array of Angular providers for the JoopInstance and its services.
+ * Use with bootstrapApplication() or provideEnvironmentInitializer().
+ *
+ *   providers: [...provideJoop(await createJoop(config))]
+ */
+declare function provideJoop(instance: JoopInstance): JoopProvider[];
+/**
+ * Minimal NgModule descriptor for use with @NgModule imports.
+ * Call JoopModule.forRoot(instance) and spread the result into the imports array.
+ *
+ *   @NgModule({ imports: [...JoopModule.forRoot(instance).providers ?? []] })
+ *
+ * For proper Angular NgModule integration, use the returned providers array
+ * directly in your app's providers:
+ *
+ *   @NgModule({ providers: JoopModule.forRoot(instance) })
+ */
+declare const JoopModule: {
+    readonly forRoot: (instance: JoopInstance) => {
+        providers: JoopProvider[];
+    };
+};
+/**
+ * Converts a JoopObservable (JoopBehaviorSubject) into an RxJS-compatible
+ * Observable. The returned object implements the Observable contract:
+ * subscribe(observer) returns a Subscription with unsubscribe().
+ *
+ *   readonly loading$ = fromJoop(this.joop.loader.isLoading$());
+ *   readonly theme$   = fromJoop(this.joop.theme.active$());
+ */
+declare function fromJoop<T>(joopObs: JoopObservable<T>): RxJSLike<T>;
+/**
+ * Converts an RxJS Observable into a JoopObservable-compatible object.
+ * Useful for bridging existing RxJS streams into JoopJS services.
+ */
+declare function toJoop<T>(rxjsObs: RxJSLike<T>): JoopObservable<T>;
+interface RxJSLike<T> {
+    subscribe(observerOrNext: ((value: T) => void) | {
+        next?: (v: T) => void;
+        error?: (e: unknown) => void;
+        complete?: () => void;
+    }): {
+        unsubscribe(): void;
+    };
+    pipe(...operators: Array<(obs: RxJSLike<T>) => RxJSLike<unknown>>): RxJSLike<unknown>;
+}
+/**
+ * Returns a factory for wrapping JoopObservable subscriptions inside Angular's
+ * change detection zone. Pass NgZone.run as the runner.
+ *
+ *   const zonedFromJoop = createZonedFromJoop(zone.run.bind(zone));
+ *   readonly theme$ = zonedFromJoop(this.joop.theme.active$());
+ */
+declare function createZonedFromJoop(zoneRun: <T>(fn: () => T) => T): <T>(obs: JoopObservable<T>) => RxJSLike<T>;
+
+export { JOOP, JOOP_ALERT, JOOP_ANALYTICS, JOOP_AUDIT_LOG, JOOP_AUTH, JOOP_FEATURE_FLAGS, JOOP_HTTP, JOOP_I18N, JOOP_KEY_VAULT, JOOP_LIFECYCLE, JOOP_LOADER, JOOP_NETWORK, JOOP_ROUTER, JOOP_STORE, JOOP_THEME, JoopModule, type JoopProvider, type RxJSLike, createZonedFromJoop, fromJoop, provideJoop, toJoop };

package/dist/angular/index.js

@@ -0,0 +1,122 @@
+'use strict';
+
+// src/angular/index.ts
+var JOOP = "JOOP_INSTANCE";
+var JOOP_AUTH = "JOOP_AUTH";
+var JOOP_THEME = "JOOP_THEME";
+var JOOP_I18N = "JOOP_I18N";
+var JOOP_HTTP = "JOOP_HTTP";
+var JOOP_LOADER = "JOOP_LOADER";
+var JOOP_ALERT = "JOOP_ALERT";
+var JOOP_ROUTER = "JOOP_ROUTER";
+var JOOP_ANALYTICS = "JOOP_ANALYTICS";
+var JOOP_FEATURE_FLAGS = "JOOP_FEATURE_FLAGS";
+var JOOP_AUDIT_LOG = "JOOP_AUDIT_LOG";
+var JOOP_STORE = "JOOP_STORE";
+var JOOP_KEY_VAULT = "JOOP_KEY_VAULT";
+var JOOP_NETWORK = "JOOP_NETWORK";
+var JOOP_LIFECYCLE = "JOOP_LIFECYCLE";
+function provideJoop(instance) {
+  return [
+    { provide: JOOP, useValue: instance },
+    { provide: JOOP_AUTH, useValue: instance.auth },
+    { provide: JOOP_THEME, useValue: instance.theme },
+    { provide: JOOP_I18N, useValue: instance.i18n },
+    { provide: JOOP_HTTP, useValue: instance.http },
+    { provide: JOOP_LOADER, useValue: instance.loader },
+    { provide: JOOP_ALERT, useValue: instance.alert },
+    { provide: JOOP_ROUTER, useValue: instance.router },
+    { provide: JOOP_ANALYTICS, useValue: instance.analytics },
+    { provide: JOOP_FEATURE_FLAGS, useValue: instance.featureFlags },
+    { provide: JOOP_AUDIT_LOG, useValue: instance.auditLog },
+    { provide: JOOP_STORE, useValue: instance.store },
+    { provide: JOOP_KEY_VAULT, useValue: instance.keyVault },
+    { provide: JOOP_NETWORK, useValue: instance.network },
+    { provide: JOOP_LIFECYCLE, useValue: instance.lifecycle }
+  ];
+}
+var JoopModule = {
+  forRoot(instance) {
+    return { providers: provideJoop(instance) };
+  }
+};
+function fromJoop(joopObs) {
+  return {
+    subscribe(observerOrNext) {
+      const next = typeof observerOrNext === "function" ? observerOrNext : observerOrNext.next?.bind(observerOrNext) ?? ((_) => {
+      });
+      const unsubscribe = joopObs.subscribe(next);
+      return { unsubscribe };
+    },
+    pipe(...operators) {
+      return operators.reduce((acc, op) => op(acc), this);
+    }
+  };
+}
+function toJoop(rxjsObs) {
+  const handlers = /* @__PURE__ */ new Set();
+  let rxSub = null;
+  return {
+    subscribe(fn) {
+      handlers.add(fn);
+      if (!rxSub) {
+        rxSub = rxjsObs.subscribe((v) => handlers.forEach((h) => h(v)));
+      }
+      return () => {
+        handlers.delete(fn);
+        if (handlers.size === 0) {
+          rxSub?.unsubscribe();
+          rxSub = null;
+        }
+      };
+    },
+    pipe(transform) {
+      return toJoop({
+        subscribe: (obs) => rxjsObs.subscribe({
+          next: (v) => typeof obs === "function" ? obs(transform(v)) : obs.next?.(transform(v))
+        }),
+        pipe: () => {
+          throw new Error("pipe chaining not supported in toJoop bridge");
+        }
+      });
+    }
+  };
+}
+function createZonedFromJoop(zoneRun) {
+  return (obs) => {
+    return {
+      subscribe(observerOrNext) {
+        const next = typeof observerOrNext === "function" ? observerOrNext : observerOrNext.next?.bind(observerOrNext) ?? ((_) => {
+        });
+        const unsubscribe = obs.subscribe((v) => zoneRun(() => next(v)));
+        return { unsubscribe };
+      },
+      pipe(...operators) {
+        return operators.reduce((acc, op) => op(acc), this);
+      }
+    };
+  };
+}
+
+exports.JOOP = JOOP;
+exports.JOOP_ALERT = JOOP_ALERT;
+exports.JOOP_ANALYTICS = JOOP_ANALYTICS;
+exports.JOOP_AUDIT_LOG = JOOP_AUDIT_LOG;
+exports.JOOP_AUTH = JOOP_AUTH;
+exports.JOOP_FEATURE_FLAGS = JOOP_FEATURE_FLAGS;
+exports.JOOP_HTTP = JOOP_HTTP;
+exports.JOOP_I18N = JOOP_I18N;
+exports.JOOP_KEY_VAULT = JOOP_KEY_VAULT;
+exports.JOOP_LIFECYCLE = JOOP_LIFECYCLE;
+exports.JOOP_LOADER = JOOP_LOADER;
+exports.JOOP_NETWORK = JOOP_NETWORK;
+exports.JOOP_ROUTER = JOOP_ROUTER;
+exports.JOOP_STORE = JOOP_STORE;
+exports.JOOP_THEME = JOOP_THEME;
+exports.JoopModule = JoopModule;
+exports.createZonedFromJoop = createZonedFromJoop;
+exports.fromJoop = fromJoop;
+exports.provideJoop = provideJoop;
+exports.toJoop = toJoop;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/angular/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/angular/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * joopjs/angular — Angular integration\n *\n * @angular/core 17+ is a required peer dependency.\n *\n * Standalone (recommended):\n *   bootstrapApplication(AppComponent, {\n *     providers: [provideJoop(joopInstance)]\n *   });\n *\n * NgModule (legacy):\n *   @NgModule({ imports: [JoopModule.forRoot(joopInstance)] })\n *\n * Inject anywhere:\n *   constructor(@Inject(JOOP) private joop: JoopInstance) {}\n *\n * RxJS bridge:\n *   readonly theme$ = fromJoop(this.joop.theme.active$());\n */\n\nimport type { JoopInstance } from '../joop';\nimport type { JoopObservable } from '../events';\n\n// ── Injection token ───────────────────────────────────────────────────────────\n\n/**\n * InjectionToken for the JoopInstance.\n * Angular's DI accepts any object as a token — use this with @Inject(JOOP).\n *\n * Example with @angular/core InjectionToken (recommended):\n *   import { InjectionToken } from '@angular/core';\n *   const JOOP = new InjectionToken<JoopInstance>('JoopInstance');\n *\n * The string form below works for both class-based and object-literal tokens.\n */\nexport const JOOP = 'JOOP_INSTANCE' as const;\nexport const JOOP_AUTH          = 'JOOP_AUTH'           as const;\nexport const JOOP_THEME         = 'JOOP_THEME'          as const;\nexport const JOOP_I18N          = 'JOOP_I18N'           as const;\nexport const JOOP_HTTP          = 'JOOP_HTTP'           as const;\nexport const JOOP_LOADER        = 'JOOP_LOADER'         as const;\nexport const JOOP_ALERT         = 'JOOP_ALERT'          as const;\nexport const JOOP_ROUTER        = 'JOOP_ROUTER'         as const;\nexport const JOOP_ANALYTICS     = 'JOOP_ANALYTICS'      as const;\nexport const JOOP_FEATURE_FLAGS = 'JOOP_FEATURE_FLAGS'  as const;\nexport const JOOP_AUDIT_LOG     = 'JOOP_AUDIT_LOG'      as const;\nexport const JOOP_STORE         = 'JOOP_STORE'          as const;\nexport const JOOP_KEY_VAULT     = 'JOOP_KEY_VAULT'      as const;\nexport const JOOP_NETWORK       = 'JOOP_NETWORK'        as const;\nexport const JOOP_LIFECYCLE     = 'JOOP_LIFECYCLE'      as const;\n\n// ── Provider types ────────────────────────────────────────────────────────────\n\nexport interface JoopProvider {\n  provide: string;\n  useValue: unknown;\n}\n\n// ── Provider factory ──────────────────────────────────────────────────────────\n\n/**\n * Returns an array of Angular providers for the JoopInstance and its services.\n * Use with bootstrapApplication() or provideEnvironmentInitializer().\n *\n *   providers: [...provideJoop(await createJoop(config))]\n */\nexport function provideJoop(instance: JoopInstance): JoopProvider[] {\n  return [\n    { provide: JOOP,              useValue: instance },\n    { provide: JOOP_AUTH,         useValue: instance.auth },\n    { provide: JOOP_THEME,        useValue: instance.theme },\n    { provide: JOOP_I18N,         useValue: instance.i18n },\n    { provide: JOOP_HTTP,         useValue: instance.http },\n    { provide: JOOP_LOADER,       useValue: instance.loader },\n    { provide: JOOP_ALERT,        useValue: instance.alert },\n    { provide: JOOP_ROUTER,       useValue: instance.router },\n    { provide: JOOP_ANALYTICS,    useValue: instance.analytics },\n    { provide: JOOP_FEATURE_FLAGS,useValue: instance.featureFlags },\n    { provide: JOOP_AUDIT_LOG,    useValue: instance.auditLog },\n    { provide: JOOP_STORE,        useValue: instance.store },\n    { provide: JOOP_KEY_VAULT,    useValue: instance.keyVault },\n    { provide: JOOP_NETWORK,      useValue: instance.network },\n    { provide: JOOP_LIFECYCLE,    useValue: instance.lifecycle },\n  ];\n}\n\n// ── NgModule helper ───────────────────────────────────────────────────────────\n\n/**\n * Minimal NgModule descriptor for use with @NgModule imports.\n * Call JoopModule.forRoot(instance) and spread the result into the imports array.\n *\n *   @NgModule({ imports: [...JoopModule.forRoot(instance).providers ?? []] })\n *\n * For proper Angular NgModule integration, use the returned providers array\n * directly in your app's providers:\n *\n *   @NgModule({ providers: JoopModule.forRoot(instance) })\n */\nexport const JoopModule = {\n  forRoot(instance: JoopInstance): { providers: JoopProvider[] } {\n    return { providers: provideJoop(instance) };\n  },\n} as const;\n\n// ── RxJS bridge ───────────────────────────────────────────────────────────────\n\n/**\n * Converts a JoopObservable (JoopBehaviorSubject) into an RxJS-compatible\n * Observable. The returned object implements the Observable contract:\n * subscribe(observer) returns a Subscription with unsubscribe().\n *\n *   readonly loading$ = fromJoop(this.joop.loader.isLoading$());\n *   readonly theme$   = fromJoop(this.joop.theme.active$());\n */\nexport function fromJoop<T>(joopObs: JoopObservable<T>): RxJSLike<T> {\n  return {\n    subscribe(\n      observerOrNext:\n        | ((value: T) => void)\n        | { next?: (v: T) => void; error?: (e: unknown) => void; complete?: () => void },\n    ): { unsubscribe(): void } {\n      const next =\n        typeof observerOrNext === 'function'\n          ? observerOrNext\n          : (observerOrNext.next?.bind(observerOrNext) ?? ((_: T) => {}));\n      const unsubscribe = joopObs.subscribe(next);\n      return { unsubscribe };\n    },\n    pipe(...operators: Array<(obs: RxJSLike<T>) => RxJSLike<unknown>>): RxJSLike<unknown> {\n      return operators.reduce((acc, op) => op(acc), this as RxJSLike<unknown>);\n    },\n  };\n}\n\n/**\n * Converts an RxJS Observable into a JoopObservable-compatible object.\n * Useful for bridging existing RxJS streams into JoopJS services.\n */\nexport function toJoop<T>(rxjsObs: RxJSLike<T>): JoopObservable<T> {\n  const handlers = new Set<(v: T) => void>();\n  let rxSub: { unsubscribe(): void } | null = null;\n\n  return {\n    subscribe(fn: (v: T) => void): () => void {\n      handlers.add(fn);\n      if (!rxSub) {\n        rxSub = rxjsObs.subscribe(v => handlers.forEach(h => h(v)));\n      }\n      return () => {\n        handlers.delete(fn);\n        if (handlers.size === 0) { rxSub?.unsubscribe(); rxSub = null; }\n      };\n    },\n    pipe(transform: (v: T) => unknown): JoopObservable<unknown> {\n      return toJoop({\n        subscribe: (obs) => rxjsObs.subscribe({\n          next: (v) => typeof obs === 'function' ? obs(transform(v)) : obs.next?.(transform(v) as never),\n        }),\n        pipe: () => { throw new Error('pipe chaining not supported in toJoop bridge'); },\n      }) as JoopObservable<unknown>;\n    },\n  } as unknown as JoopObservable<T>;\n}\n\n// ── Minimal RxJS-compatible Observable type ───────────────────────────────────\n\nexport interface RxJSLike<T> {\n  subscribe(\n    observerOrNext:\n      | ((value: T) => void)\n      | { next?: (v: T) => void; error?: (e: unknown) => void; complete?: () => void },\n  ): { unsubscribe(): void };\n  pipe(...operators: Array<(obs: RxJSLike<T>) => RxJSLike<unknown>>): RxJSLike<unknown>;\n}\n\n// ── Change detection helper ───────────────────────────────────────────────────\n\n/**\n * Returns a factory for wrapping JoopObservable subscriptions inside Angular's\n * change detection zone. Pass NgZone.run as the runner.\n *\n *   const zonedFromJoop = createZonedFromJoop(zone.run.bind(zone));\n *   readonly theme$ = zonedFromJoop(this.joop.theme.active$());\n */\nexport function createZonedFromJoop(\n  zoneRun: <T>(fn: () => T) => T,\n): <T>(obs: JoopObservable<T>) => RxJSLike<T> {\n  return <T>(obs: JoopObservable<T>): RxJSLike<T> => {\n    return {\n      subscribe(observerOrNext) {\n        const next =\n          typeof observerOrNext === 'function'\n            ? observerOrNext\n            : (observerOrNext.next?.bind(observerOrNext) ?? ((_: T) => {}));\n        const unsubscribe = obs.subscribe(v => zoneRun(() => next(v)));\n        return { unsubscribe };\n      },\n      pipe(...operators) {\n        return operators.reduce((acc, op) => op(acc), this as RxJSLike<unknown>);\n      },\n    };\n  };\n}\n"]}