aril 2.0.1-dev.5 → 2.0.1

package/theme/layout/service/tab-session.service.ts

@@ -1,138 +1,138 @@
-import { Injectable, Injector, effect, inject } from '@angular/core';
-
-import { KeycloakService } from 'keycloak-angular';
-
-import { NavItem, NavService } from 'aril/boot/config/apps';
-
-/**
- * localStorage'a serialize edilen pinned tab kaydı. `pinned` alanı SAKLANMAZ
- * (yüklenen her kayıt zaten pinned'dir). `tabId` SAKLANIR — F5 sonrası
- * `window.history.state._tab` ile eşleşip `NavService.activeRoute` handler'ının
- * aynı tab'ı tekrar türetmesini (duplicate) engeller.
- */
-interface PersistedTab {
-	tabId: string;
-	navLink: string;
-	navName: string;
-	icon?: string;
-}
-
-/**
- * Sabitlenmiş (pinned) tab'ları kullanıcı bazlı `localStorage` anahtarında kalıcı
- * kılar. F5 / yeniden login / yeni sekme açılışında pinned tab'lar geri yüklenir;
- * non-pinned tab'lar saklanmaz.
- *
- * **Akış**: `AppLayoutComponent` constructor'da (menü/home provider'ları set
- * edildikten SONRA) `restore()` SENKRON çağrılır → pinned'ler `NavService.activeRoutes`'a
- * eklenir → save effect armlanır. Save effect `restore()` ÖNCESİ kurulmaz; aksi
- * halde Angular effect'in ilk (eager) tick'i boş `activeRoutes`'u yazıp saklı
- * pinned'leri silerdi.
- *
- * **Duplicate önlemi**: Aktif tab pinned'di ise restore SAKLI `tabId` ile ekler;
- * F5 sonrası korunan `history.state._tab` bununla eşleşir → handler türetmez, sadece
- * focus eder. Aktif tab pinned değildiyse eşleşme olmaz → handler gelen URL'i yeni
- * aktif tab olarak ekler (deep-link gereksinimi: "kayıtlıları yükle + URL'i ekle").
- */
-@Injectable({ providedIn: 'root' })
-export class TabSessionService {
-	private readonly navService = inject(NavService);
-	private readonly keycloak = inject(KeycloakService);
-	private readonly injector = inject(Injector);
-
-	private readonly STORAGE_PREFIX = 'tab-session:';
-	/** `NavService.MAX_TABS` ile aynı tavan — restore ve save iki tarafta da sınırlanır. */
-	private readonly MAX_PERSISTED = 20;
-
-	private restored = false;
-	/** Son yazılan payload — değişmediyse gereksiz `localStorage` write'ı atlanır. */
-	private lastWritten = '';
-
-	/**
-	 * Kullanıcı bazlı storage anahtarı. Mevcut kod (`app.profilesidebar.component.ts`)
-	 * `idTokenParsed.sub` kullanıyor; her iki token şeklini de kapsamak için fallback
-	 * zinciri — kullanıcı çözülemezse `anonymous`.
-	 */
-	private storageKey(): string {
-		const kc = this.keycloak.getKeycloakInstance();
-		const sub = kc?.tokenParsed?.sub ?? kc?.idTokenParsed?.sub ?? 'anonymous';
-		return this.STORAGE_PREFIX + sub;
-	}
-
-	/**
-	 * SENKRON restore. `AppLayoutComponent` constructor'dan, ilk `NavigationEnd`
-	 * işlenmeden ÖNCE çağrılmalı — böylece `NavService.activeRoute` handler'ının
-	 * `knownTab` guard'ı restore edilen tabId'leri görür. Idempotent: ikinci çağrı no-op.
-	 */
-	restore(): void {
-		if (this.restored) return;
-		const persisted = this.load();
-		const existingIds = new Set(this.navService.activeRoutes().map((t) => t.tabId));
-		for (const item of persisted) {
-			// Aynı tabId zaten ekliyse atla (idempotency / olası çift çağrı koruması).
-			if (existingIds.has(item.tabId)) continue;
-			this.navService.addToActiveRoutes({
-				tabId: item.tabId,
-				navLink: item.navLink,
-				navName: item.navName,
-				icon: item.icon,
-				pinned: true
-			});
-		}
-		this.restored = true;
-		this.armSave();
-	}
-
-	/**
-	 * Save effect'ini `restore()` SONRASI kurar. İlk çalıştığında `activeRoutes` zaten
-	 * restore edilmiş pinned'leri içerdiği için yazım idempotent kalır. Effect, service'in
-	 * kendi `Injector`'ına bağlanır (field initializer / constructor dışında kurulduğu için
-	 * explicit injector zorunlu).
-	 */
-	private armSave(): void {
-		effect(
-			() => {
-				const pinned = this.navService.activeRoutes().filter((t) => t.pinned);
-				this.save(pinned);
-			},
-			{ injector: this.injector }
-		);
-	}
-
-	private save(pinned: NavItem[]): void {
-		try {
-			const payload: PersistedTab[] = pinned
-				.slice(0, this.MAX_PERSISTED)
-				.map((t) => ({ tabId: t.tabId, navLink: t.navLink, navName: t.navName, icon: t.icon }));
-			const serialized = JSON.stringify(payload);
-			if (serialized === this.lastWritten) return;
-			this.lastWritten = serialized;
-			localStorage.setItem(this.storageKey(), serialized);
-		} catch {
-			/* quota / serialize hatası: kritik değil, persist sessizce atlanır */
-		}
-	}
-
-	private load(): PersistedTab[] {
-		try {
-			const raw = localStorage.getItem(this.storageKey());
-			if (!raw) return [];
-			const parsed: unknown = JSON.parse(raw);
-			if (!Array.isArray(parsed)) return [];
-			return parsed.filter((x): x is PersistedTab => this.isValidPersistedTab(x));
-		} catch {
-			return []; // bozuk JSON → yok say, uygulama normal açılır
-		}
-	}
-
-	private isValidPersistedTab(x: unknown): x is PersistedTab {
-		if (!x || typeof x !== 'object') return false;
-		const t = x as Record<string, unknown>;
-		return (
-			typeof t['tabId'] === 'string' &&
-			t['tabId'].length > 0 &&
-			typeof t['navLink'] === 'string' &&
-			t['navLink'].length > 0 &&
-			typeof t['navName'] === 'string'
-		);
-	}
-}
+import { Injectable, Injector, effect, inject } from '@angular/core';
+
+import { KeycloakService } from 'keycloak-angular';
+
+import { NavItem, NavService } from 'aril/boot/config/apps';
+
+/**
+ * localStorage'a serialize edilen pinned tab kaydı. `pinned` alanı SAKLANMAZ
+ * (yüklenen her kayıt zaten pinned'dir). `tabId` SAKLANIR — F5 sonrası
+ * `window.history.state._tab` ile eşleşip `NavService.activeRoute` handler'ının
+ * aynı tab'ı tekrar türetmesini (duplicate) engeller.
+ */
+interface PersistedTab {
+	tabId: string;
+	navLink: string;
+	navName: string;
+	icon?: string;
+}
+
+/**
+ * Sabitlenmiş (pinned) tab'ları kullanıcı bazlı `localStorage` anahtarında kalıcı
+ * kılar. F5 / yeniden login / yeni sekme açılışında pinned tab'lar geri yüklenir;
+ * non-pinned tab'lar saklanmaz.
+ *
+ * **Akış**: `AppLayoutComponent` constructor'da (menü/home provider'ları set
+ * edildikten SONRA) `restore()` SENKRON çağrılır → pinned'ler `NavService.activeRoutes`'a
+ * eklenir → save effect armlanır. Save effect `restore()` ÖNCESİ kurulmaz; aksi
+ * halde Angular effect'in ilk (eager) tick'i boş `activeRoutes`'u yazıp saklı
+ * pinned'leri silerdi.
+ *
+ * **Duplicate önlemi**: Aktif tab pinned'di ise restore SAKLI `tabId` ile ekler;
+ * F5 sonrası korunan `history.state._tab` bununla eşleşir → handler türetmez, sadece
+ * focus eder. Aktif tab pinned değildiyse eşleşme olmaz → handler gelen URL'i yeni
+ * aktif tab olarak ekler (deep-link gereksinimi: "kayıtlıları yükle + URL'i ekle").
+ */
+@Injectable({ providedIn: 'root' })
+export class TabSessionService {
+	private readonly navService = inject(NavService);
+	private readonly keycloak = inject(KeycloakService);
+	private readonly injector = inject(Injector);
+
+	private readonly STORAGE_PREFIX = 'tab-session:';
+	/** `NavService.MAX_TABS` ile aynı tavan — restore ve save iki tarafta da sınırlanır. */
+	private readonly MAX_PERSISTED = 20;
+
+	private restored = false;
+	/** Son yazılan payload — değişmediyse gereksiz `localStorage` write'ı atlanır. */
+	private lastWritten = '';
+
+	/**
+	 * Kullanıcı bazlı storage anahtarı. Mevcut kod (`app.profilesidebar.component.ts`)
+	 * `idTokenParsed.sub` kullanıyor; her iki token şeklini de kapsamak için fallback
+	 * zinciri — kullanıcı çözülemezse `anonymous`.
+	 */
+	private storageKey(): string {
+		const kc = this.keycloak.getKeycloakInstance();
+		const sub = kc?.tokenParsed?.sub ?? kc?.idTokenParsed?.sub ?? 'anonymous';
+		return this.STORAGE_PREFIX + sub;
+	}
+
+	/**
+	 * SENKRON restore. `AppLayoutComponent` constructor'dan, ilk `NavigationEnd`
+	 * işlenmeden ÖNCE çağrılmalı — böylece `NavService.activeRoute` handler'ının
+	 * `knownTab` guard'ı restore edilen tabId'leri görür. Idempotent: ikinci çağrı no-op.
+	 */
+	restore(): void {
+		if (this.restored) return;
+		const persisted = this.load();
+		const existingIds = new Set(this.navService.activeRoutes().map((t) => t.tabId));
+		for (const item of persisted) {
+			// Aynı tabId zaten ekliyse atla (idempotency / olası çift çağrı koruması).
+			if (existingIds.has(item.tabId)) continue;
+			this.navService.addToActiveRoutes({
+				tabId: item.tabId,
+				navLink: item.navLink,
+				navName: item.navName,
+				icon: item.icon,
+				pinned: true
+			});
+		}
+		this.restored = true;
+		this.armSave();
+	}
+
+	/**
+	 * Save effect'ini `restore()` SONRASI kurar. İlk çalıştığında `activeRoutes` zaten
+	 * restore edilmiş pinned'leri içerdiği için yazım idempotent kalır. Effect, service'in
+	 * kendi `Injector`'ına bağlanır (field initializer / constructor dışında kurulduğu için
+	 * explicit injector zorunlu).
+	 */
+	private armSave(): void {
+		effect(
+			() => {
+				const pinned = this.navService.activeRoutes().filter((t) => t.pinned);
+				this.save(pinned);
+			},
+			{ injector: this.injector }
+		);
+	}
+
+	private save(pinned: NavItem[]): void {
+		try {
+			const payload: PersistedTab[] = pinned
+				.slice(0, this.MAX_PERSISTED)
+				.map((t) => ({ tabId: t.tabId, navLink: t.navLink, navName: t.navName, icon: t.icon }));
+			const serialized = JSON.stringify(payload);
+			if (serialized === this.lastWritten) return;
+			this.lastWritten = serialized;
+			localStorage.setItem(this.storageKey(), serialized);
+		} catch {
+			/* quota / serialize hatası: kritik değil, persist sessizce atlanır */
+		}
+	}
+
+	private load(): PersistedTab[] {
+		try {
+			const raw = localStorage.getItem(this.storageKey());
+			if (!raw) return [];
+			const parsed: unknown = JSON.parse(raw);
+			if (!Array.isArray(parsed)) return [];
+			return parsed.filter((x): x is PersistedTab => this.isValidPersistedTab(x));
+		} catch {
+			return []; // bozuk JSON → yok say, uygulama normal açılır
+		}
+	}
+
+	private isValidPersistedTab(x: unknown): x is PersistedTab {
+		if (!x || typeof x !== 'object') return false;
+		const t = x as Record<string, unknown>;
+		return (
+			typeof t['tabId'] === 'string' &&
+			t['tabId'].length > 0 &&
+			typeof t['navLink'] === 'string' &&
+			t['navLink'].length > 0 &&
+			typeof t['navName'] === 'string'
+		);
+	}
+}