@gostack-framework/ui 0.0.0-stage → 0.1.0

package/src/typography/typography.adapter.ts

@@ -0,0 +1,131 @@
+/**
+ * Typography Persistence Adapter
+ * Isolates data storage logic behind a clean contract.
+ * Allows effortless swapping between LocalStorage and REST/GraphQL API.
+ */
+
+import { DEFAULT_TYPOGRAPHY_CONFIG } from "./typography.constants";
+import { TypographyConfig, TypographyRepository } from "./typography.types";
+
+const STORAGE_KEY = "gostack_typography_config_v1";
+
+/**
+ * LocalStorage Repository Implementation
+ * Synchronous read/write fallback suitable for client-side persistence.
+ */
+export const typographyLocalStorageRepository: TypographyRepository = {
+    getConfig: (): TypographyConfig => {
+        if (typeof window === "undefined") {
+            return DEFAULT_TYPOGRAPHY_CONFIG;
+        }
+
+        try {
+            const raw = localStorage.getItem(STORAGE_KEY);
+            if (!raw) return DEFAULT_TYPOGRAPHY_CONFIG;
+
+            const parsed = JSON.parse(raw);
+            return {
+                ...DEFAULT_TYPOGRAPHY_CONFIG,
+                ...parsed,
+            };
+        } catch (error) {
+            console.warn(
+                "[TypographyRepository] Failed to read config from localStorage, using defaults:",
+                error,
+            );
+            return DEFAULT_TYPOGRAPHY_CONFIG;
+        }
+    },
+
+    saveConfig: (config: TypographyConfig): void => {
+        if (typeof window === "undefined") return;
+
+        try {
+            localStorage.setItem(STORAGE_KEY, JSON.stringify(config));
+        } catch (error) {
+            console.error(
+                "[TypographyRepository] Failed to save config to localStorage:",
+                error,
+            );
+        }
+    },
+
+    resetConfig: (): void => {
+        if (typeof window === "undefined") return;
+
+        try {
+            localStorage.removeItem(STORAGE_KEY);
+        } catch (error) {
+            console.error(
+                "[TypographyRepository] Failed to clear config from localStorage:",
+                error,
+            );
+        }
+    },
+};
+
+/**
+ * REST / GraphQL API Repository Stub
+ * Template for seamless backend integration when migrating away from LocalStorage.
+ */
+export const createTypographyApiRepository = (
+    apiEndpoint = "/api/v1/settings/typography",
+): TypographyRepository => ({
+    getConfig: async (): Promise<TypographyConfig> => {
+        try {
+            const response = await fetch(apiEndpoint, {
+                headers: { "Content-Type": "application/json" },
+            });
+            if (!response.ok) throw new Error(`HTTP ${response.status}`);
+            const json = await response.json();
+            return { ...DEFAULT_TYPOGRAPHY_CONFIG, ...json.data };
+        } catch (error) {
+            console.warn(
+                "[TypographyApiRepository] API call failed, fallback to defaults:",
+                error,
+            );
+            return typographyLocalStorageRepository.getConfig();
+        }
+    },
+
+    saveConfig: async (config: TypographyConfig): Promise<void> => {
+        try {
+            const response = await fetch(apiEndpoint, {
+                method: "PUT",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(config),
+            });
+            if (!response.ok) throw new Error(`HTTP ${response.status}`);
+            // Also mirror to localStorage for offline cache
+            typographyLocalStorageRepository.saveConfig(config);
+        } catch (error) {
+            console.error("[TypographyApiRepository] Failed to save to API:", error);
+            typographyLocalStorageRepository.saveConfig(config);
+        }
+    },
+
+    resetConfig: async (): Promise<void> => {
+        try {
+            await fetch(apiEndpoint, { method: "DELETE" });
+            typographyLocalStorageRepository.resetConfig();
+        } catch (error) {
+            console.error("[TypographyApiRepository] Failed to reset on API:", error);
+            typographyLocalStorageRepository.resetConfig();
+        }
+    },
+});
+
+/**
+ * Active Repository Singleton
+ * To swap from LocalStorage to API across the entire app, simply call:
+ * `setTypographyRepository(createTypographyApiRepository('/api/v1/typography'))`
+ */
+let activeRepository: TypographyRepository = typographyLocalStorageRepository;
+
+export function getTypographyRepository(): TypographyRepository {
+    return activeRepository;
+}
+
+export function setTypographyRepository(repo: TypographyRepository): void {
+    activeRepository = repo;
+}