mythik 0.0.1 → 0.1.0

package/dist/app/app-engine.d.ts

@@ -0,0 +1,106 @@
+import type { StateStore } from '../state/store.js';
+import type { Spec, TemplateDefinition } from '../types.js';
+import type { SpecStore } from '../spec-engine/types.js';
+import type { EditorSessionEngine } from '../editor-session/types.js';
+export interface ScreenDefinition {
+    label: string;
+    icon?: string;
+    description?: string;
+    roles?: string[];
+    statePolicy?: 'preserve' | 'reset' | 'reload';
+    parent?: string;
+}
+export interface AppAuthConfig {
+    loginScreen: string;
+    protectedScreens: string[];
+    roleAccess: Record<string, string[]>;
+    /** Auth provider name. Used by MythikApp to select the provider instance. */
+    provider?: string;
+    /** Persistence strategy: "local" (default, survives browser close), "session" (tab-scoped), "memory" (no persistence). */
+    persistence?: 'local' | 'session' | 'memory';
+    /** Enable proactive token refresh before expiry. Default: true. */
+    tokenRefresh?: boolean;
+    /** Domains where Bearer token is auto-injected into fetch requests. */
+    authDomains?: string[];
+    /** Message shown as toast when session expires. */
+    sessionExpiredMessage?: string;
+    /** Declarative interceptors config for framework fetch. */
+    interceptors?: {
+        logging?: boolean;
+        timeout?: {
+            ms: number;
+        };
+        retryOnError?: {
+            maxRetries?: number;
+            statuses?: number[];
+        };
+    };
+}
+export interface AppNavigationConfig {
+    type: 'sidebar' | 'tabs' | 'drawer';
+    initialScreen: string;
+    breadcrumb?: 'history' | 'hierarchy' | 'none';
+    /** Which screens appear in the sidebar/menu, in order. Screens not listed are still navigable but hidden from the menu. If omitted, all screens are shown. */
+    menu?: string[];
+    auth?: AppAuthConfig;
+    editorSessionGuard?: AppEditorSessionGuardConfig;
+}
+export interface AppEditorSessionGuardConfig {
+    enabled?: boolean;
+    sessions?: string[];
+    blockNavigation?: boolean;
+    blockGoBack?: boolean;
+    blockBrowserUnload?: boolean;
+    pendingPath?: string;
+}
+export interface NavigationGuardDirtySession {
+    id: string;
+    label: string | null;
+    status: string;
+    saveStatus: string;
+    lastSavedAt: string | null;
+}
+export interface NavigationGuardPending {
+    kind: 'editor-session-dirty';
+    action: 'navigateScreen' | 'goBackScreen';
+    screen?: string;
+    params?: Record<string, unknown>;
+    dirtySessions: NavigationGuardDirtySession[];
+    createdAt: number;
+}
+export interface AppSpec {
+    type: 'app';
+    name?: string;
+    navigation: AppNavigationConfig;
+    screens: Record<string, ScreenDefinition>;
+    sharedState?: Record<string, unknown>;
+    tokens?: Record<string, unknown>;
+    translations?: Record<string, Record<string, string>>;
+    templates?: Record<string, TemplateDefinition>;
+    layout: {
+        root: string;
+        elements: Record<string, unknown>;
+    };
+}
+export interface AppEngineConfig {
+    appSpec: AppSpec;
+    store: StateStore;
+    specStore: SpecStore;
+}
+export interface AppEngine {
+    mount: () => void;
+    navigate: (screenId: string, params?: Record<string, unknown>) => Promise<void>;
+    goBack: () => void;
+    navigationGuardCancel: () => void;
+    navigationGuardProceed: () => Promise<void>;
+    navigationGuardSaveAndProceed: () => Promise<void>;
+    navigationGuardDiscardAndProceed: () => Promise<void>;
+    hasGuardedDirtySessions: () => boolean;
+    attachEditorSessionEngine: (engine: EditorSessionEngine | null) => void;
+    getScreenSpec: (screenId: string) => Promise<Spec>;
+    canAccess: (screenId: string, role: string) => boolean;
+    refreshScreenList: () => void;
+    unmount: () => void;
+}
+export declare function createAppEngine(config: AppEngineConfig): AppEngine;
+//# sourceMappingURL=app-engine.d.ts.map

package/dist/app/app-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-engine.d.ts","sourceRoot":"","sources":["../../src/app/app-engine.ts"],"names":[],"mappings":"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"}

package/dist/app/app-engine.js

@@ -0,0 +1,413 @@
+export function createAppEngine(config) {
+    const { appSpec, store, specStore } = config;
+    const specCache = new Map();
+    let mounted = false;
+    let bypassNavigationGuard = false;
+    let currentEditorSessionEngine = null;
+    const navigationGuard = appSpec.navigation.editorSessionGuard;
+    const navigationGuardPendingPath = navigationGuard?.pendingPath ?? '/ui/navigationGuard/pending';
+    const navigationGuardErrorPath = '/ui/navigationGuard/error';
+    // ─── Mount ───
+    function mount() {
+        if (mounted)
+            return;
+        mounted = true;
+        // Initialize shared state
+        if (appSpec.sharedState) {
+            for (const [key, value] of Object.entries(appSpec.sharedState)) {
+                store.set(`/${key}`, value);
+            }
+        }
+        // Set app metadata
+        if (appSpec.name) {
+            store.set('/app/name', appSpec.name);
+        }
+        // Populate /app/screens (for sidebar repeat)
+        refreshScreenList();
+        // Determine initial screen — respect auth if configured
+        let initialScreen = appSpec.navigation.initialScreen;
+        if (appSpec.navigation.auth) {
+            const auth = appSpec.navigation.auth;
+            const protected_ = auth.protectedScreens ?? [];
+            const isProtected = protected_.includes('*') || protected_.includes(initialScreen);
+            if (isProtected) {
+                const isAuthenticated = store.get('/auth/isAuthenticated');
+                if (!isAuthenticated) {
+                    initialScreen = auth.loginScreen;
+                }
+            }
+        }
+        // Initialize navigation
+        store.set('/navigation/currentScreen', initialScreen);
+        store.set('/navigation/params', {});
+        store.set('/navigation/history', [initialScreen]);
+        // Compute initial breadcrumb
+        computeBreadcrumb();
+    }
+    // ─── Navigation ───
+    async function navigate(screenId, params) {
+        if (!appSpec.screens[screenId]) {
+            throw new Error(`Unknown screen: "${screenId}"`);
+        }
+        if (shouldBlockNavigation('navigateScreen', { screen: screenId, params })) {
+            return;
+        }
+        // Auth check
+        if (appSpec.navigation.auth) {
+            const auth = appSpec.navigation.auth;
+            // loginScreen is always accessible — prevents infinite redirect
+            if (screenId === auth.loginScreen) {
+                // Skip protection check, allow navigation
+            }
+            else {
+                const navProtected = auth.protectedScreens ?? [];
+                const isProtected = navProtected.includes('*') || navProtected.includes(screenId);
+                if (isProtected) {
+                    const userRoles = store.get('/auth/user/roles');
+                    const userRole = (store.get('/auth/user/role') ?? store.get('/user/role'));
+                    const hasAccess = userRoles
+                        ? userRoles.some((r) => canAccess(screenId, r))
+                        : (userRole ? canAccess(screenId, userRole) : false);
+                    if (!hasAccess) {
+                        const isAuthenticated = store.get('/auth/isAuthenticated');
+                        if (isAuthenticated) {
+                            // Logged in but unauthorized → don't navigate, set error
+                            store.set('/auth/error', `Access denied: screen "${screenId}"`);
+                            return;
+                        }
+                        // Not authenticated → redirect to login
+                        store.set('/navigation/currentScreen', auth.loginScreen);
+                        const history = store.get('/navigation/history') ?? [];
+                        store.set('/navigation/history', [...history, auth.loginScreen]);
+                        computeBreadcrumb();
+                        return;
+                    }
+                }
+            }
+        }
+        // Apply state policy for the target screen
+        const targetDef = appSpec.screens[screenId];
+        const policy = targetDef.statePolicy ?? 'preserve';
+        if (policy === 'reset') {
+            clearScreenState(screenId);
+        }
+        else if (policy === 'reload') {
+            clearScreenState(screenId);
+            store.set(`/screens/${screenId}/_reload`, true);
+        }
+        // Update navigation state
+        store.set('/navigation/currentScreen', screenId);
+        store.set('/navigation/params', params ?? {});
+        const history = store.get('/navigation/history') ?? [];
+        store.set('/navigation/history', [...history, screenId]);
+        // Compute breadcrumb
+        computeBreadcrumb();
+    }
+    function goBack() {
+        const history = store.get('/navigation/history') ?? [];
+        if (history.length <= 1)
+            return;
+        if (shouldBlockNavigation('goBackScreen')) {
+            return;
+        }
+        const newHistory = history.slice(0, -1);
+        const previousScreen = newHistory[newHistory.length - 1];
+        store.set('/navigation/currentScreen', previousScreen);
+        store.set('/navigation/history', newHistory);
+        store.set('/navigation/params', {});
+        computeBreadcrumb();
+    }
+    // ─── State policies ───
+    function clearScreenState(screenId) {
+        store.set(`/screens/${screenId}`, undefined);
+    }
+    // ─── Breadcrumb ───
+    function computeBreadcrumb() {
+        const mode = appSpec.navigation.breadcrumb ?? 'history';
+        if (mode === 'none')
+            return;
+        const currentScreen = store.get('/navigation/currentScreen');
+        if (mode === 'history') {
+            const history = store.get('/navigation/history') ?? [];
+            // Deduplicate while preserving order (last occurrence wins)
+            const seen = new Set();
+            const unique = [];
+            for (const id of history) {
+                if (!seen.has(id)) {
+                    seen.add(id);
+                    unique.push(id);
+                }
+            }
+            const breadcrumb = unique.map((id) => enrichBreadcrumbEntry(id));
+            store.set('/navigation/breadcrumb', breadcrumb);
+        }
+        else if (mode === 'hierarchy') {
+            // Walk parent chain from current screen to root
+            const chain = [];
+            let current = currentScreen;
+            const visited = new Set();
+            while (current && !visited.has(current)) {
+                visited.add(current);
+                chain.unshift(current);
+                current = appSpec.screens[current]?.parent;
+            }
+            const breadcrumb = chain.map((id) => enrichBreadcrumbEntry(id));
+            store.set('/navigation/breadcrumb', breadcrumb);
+        }
+    }
+    function enrichBreadcrumbEntry(screenId) {
+        const def = appSpec.screens[screenId];
+        if (!def)
+            return { id: screenId, label: screenId };
+        return {
+            id: screenId,
+            label: typeof def.label === 'string' ? def.label : screenId,
+            ...(def.icon ? { icon: def.icon } : {}),
+        };
+    }
+    // ─── Screen Spec Loading ───
+    async function getScreenSpec(screenId) {
+        // Return from cache if available
+        if (specCache.has(screenId)) {
+            return specCache.get(screenId);
+        }
+        // Load from store
+        const spec = await specStore.load(screenId);
+        // Merge app-level templates (screen templates override app templates)
+        if (appSpec.templates) {
+            spec.templates = {
+                ...appSpec.templates,
+                ...(spec.templates ?? {}),
+            };
+        }
+        // Cache the merged spec
+        specCache.set(screenId, spec);
+        return spec;
+    }
+    // ─── Role access ───
+    function canAccess(screenId, role) {
+        const def = appSpec.screens[screenId];
+        if (!def)
+            return false;
+        // Priority 1: roleAccess map (global override, source of truth when present)
+        const auth = appSpec.navigation.auth;
+        if (auth?.roleAccess) {
+            const allowedScreens = auth.roleAccess[role];
+            if (allowedScreens) {
+                return allowedScreens.includes('*') || allowedScreens.includes(screenId);
+            }
+            // Role not in roleAccess → no access
+            return false;
+        }
+        // Priority 2: per-screen roles (backward compat when no roleAccess)
+        const roles = def.roles ?? ['*'];
+        if (roles.includes('*'))
+            return true;
+        return roles.includes(role);
+    }
+    // ─── Sidebar screen list ───
+    function refreshScreenList() {
+        const menuIds = appSpec.navigation.menu ?? Object.keys(appSpec.screens);
+        const screensArray = menuIds
+            .filter((id) => appSpec.screens[id])
+            .filter((id) => {
+            if (!appSpec.navigation.auth)
+                return true;
+            // Exclude loginScreen from sidebar
+            if (id === appSpec.navigation.auth.loginScreen)
+                return false;
+            const userRoles = store.get('/auth/user/roles');
+            const userRole = (store.get('/auth/user/role') ?? store.get('/user/role'));
+            if (userRoles)
+                return userRoles.some((r) => canAccess(id, r));
+            if (userRole)
+                return canAccess(id, userRole);
+            return true; // Pre-login → show all
+        })
+            .map((id) => ({ id, ...appSpec.screens[id] }));
+        store.set('/app/screens', screensArray);
+    }
+    // ─── Editor session navigation guard ───
+    function attachEditorSessionEngine(engine) {
+        currentEditorSessionEngine = engine;
+    }
+    function isNavigationGuardEnabled() {
+        return navigationGuard?.enabled === true;
+    }
+    function shouldBlockNavigation(action, details = {}) {
+        if (bypassNavigationGuard || !isNavigationGuardEnabled())
+            return false;
+        if (action === 'navigateScreen' && navigationGuard?.blockNavigation === false)
+            return false;
+        if (action === 'goBackScreen' && navigationGuard?.blockGoBack === false)
+            return false;
+        const dirtySessions = getGuardedDirtySessions();
+        if (dirtySessions.length === 0)
+            return false;
+        const pending = {
+            kind: 'editor-session-dirty',
+            action,
+            ...(details.screen ? { screen: details.screen } : {}),
+            ...(details.params ? { params: details.params } : {}),
+            dirtySessions,
+            createdAt: Date.now(),
+        };
+        store.set(navigationGuardPendingPath, pending);
+        store.set(navigationGuardErrorPath, undefined);
+        return true;
+    }
+    function getGuardedDirtySessions(sessionIds = navigationGuard?.sessions) {
+        if (!isNavigationGuardEnabled())
+            return [];
+        if (sessionIds && sessionIds.length > 0) {
+            return sessionIds
+                .map((id) => toDirtySession(id, store.get(`/ui/editorSessions/${id}`)))
+                .filter((session) => session !== null);
+        }
+        const sessions = store.get('/ui/editorSessions');
+        if (!isRecord(sessions))
+            return [];
+        return Object.entries(sessions)
+            .map(([id, value]) => toDirtySession(id, value))
+            .filter((session) => session !== null);
+    }
+    function toDirtySession(id, value) {
+        if (!isRecord(value) || value.dirty !== true)
+            return null;
+        return {
+            id: typeof value.id === 'string' && value.id ? value.id : id,
+            label: typeof value.label === 'string' ? value.label : null,
+            status: typeof value.status === 'string' ? value.status : 'dirty',
+            saveStatus: typeof value.saveStatus === 'string' ? value.saveStatus : 'idle',
+            lastSavedAt: typeof value.lastSavedAt === 'string' ? value.lastSavedAt : null,
+        };
+    }
+    function isRecord(value) {
+        return typeof value === 'object' && value !== null && !Array.isArray(value);
+    }
+    function hasGuardedDirtySessions() {
+        return getGuardedDirtySessions().length > 0;
+    }
+    function navigationGuardCancel() {
+        store.set(navigationGuardPendingPath, undefined);
+        store.set(navigationGuardErrorPath, undefined);
+    }
+    async function navigationGuardProceed() {
+        const pending = getPendingNavigation();
+        if (!pending)
+            return;
+        const dirtySessionIds = pending.dirtySessions.map((session) => session.id);
+        const stillDirty = getGuardedDirtySessions(dirtySessionIds);
+        if (stillDirty.length > 0) {
+            store.set(navigationGuardErrorPath, {
+                message: 'Navigation guard pending sessions are still dirty. Save or discard changes before proceeding.',
+                dirtySessions: stillDirty,
+            });
+            return;
+        }
+        await runPendingNavigation(pending);
+    }
+    async function navigationGuardSaveAndProceed() {
+        const pending = getPendingNavigation();
+        if (!pending)
+            return;
+        if (!currentEditorSessionEngine) {
+            store.set(navigationGuardErrorPath, {
+                message: 'No editor session engine is attached; cannot save guarded changes.',
+            });
+            return;
+        }
+        try {
+            for (const session of pending.dirtySessions) {
+                await currentEditorSessionEngine.save({ session: session.id });
+            }
+        }
+        catch (error) {
+            store.set(navigationGuardErrorPath, {
+                message: error instanceof Error ? error.message : 'Failed to save guarded editor session changes.',
+            });
+            return;
+        }
+        const dirtySessionIds = pending.dirtySessions.map((session) => session.id);
+        const stillDirty = getGuardedDirtySessions(dirtySessionIds);
+        if (stillDirty.length > 0) {
+            store.set(navigationGuardErrorPath, {
+                message: 'Navigation guard pending sessions are still dirty. Save or discard changes before proceeding.',
+                dirtySessions: stillDirty,
+            });
+            return;
+        }
+        await runPendingNavigation(pending);
+    }
+    async function navigationGuardDiscardAndProceed() {
+        const pending = getPendingNavigation();
+        if (!pending)
+            return;
+        if (!currentEditorSessionEngine) {
+            store.set(navigationGuardErrorPath, {
+                message: 'No editor session engine is attached; cannot discard guarded changes.',
+            });
+            return;
+        }
+        try {
+            for (const session of pending.dirtySessions) {
+                currentEditorSessionEngine.discard(session.id);
+            }
+        }
+        catch (error) {
+            store.set(navigationGuardErrorPath, {
+                message: error instanceof Error ? error.message : 'Failed to discard guarded editor session changes.',
+            });
+            return;
+        }
+        await runPendingNavigation(pending);
+    }
+    function getPendingNavigation() {
+        const pending = store.get(navigationGuardPendingPath);
+        if (!isRecord(pending) || pending.kind !== 'editor-session-dirty')
+            return null;
+        if (pending.action !== 'navigateScreen' && pending.action !== 'goBackScreen')
+            return null;
+        if (!Array.isArray(pending.dirtySessions))
+            return null;
+        return pending;
+    }
+    async function runPendingNavigation(pending) {
+        store.set(navigationGuardPendingPath, undefined);
+        store.set(navigationGuardErrorPath, undefined);
+        bypassNavigationGuard = true;
+        try {
+            if (pending.action === 'goBackScreen') {
+                goBack();
+            }
+            else if (pending.screen) {
+                await navigate(pending.screen, pending.params);
+            }
+        }
+        finally {
+            bypassNavigationGuard = false;
+        }
+    }
+    // ─── Unmount ───
+    function unmount() {
+        mounted = false;
+        specCache.clear();
+        currentEditorSessionEngine = null;
+    }
+    return {
+        mount,
+        navigate,
+        goBack,
+        navigationGuardCancel,
+        navigationGuardProceed,
+        navigationGuardSaveAndProceed,
+        navigationGuardDiscardAndProceed,
+        hasGuardedDirtySessions,
+        attachEditorSessionEngine,
+        getScreenSpec,
+        canAccess,
+        refreshScreenList,
+        unmount,
+    };
+}
+//# sourceMappingURL=app-engine.js.map

package/dist/app/app-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-engine.js","sourceRoot":"","sources":["../../src/app/app-engine.ts"],"names":[],"mappings":"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"}

package/dist/auth/cross-tab.d.ts

@@ -0,0 +1,24 @@
+import type { AuthEvent } from './types.js';
+export interface CrossTabSync {
+    /** Broadcast an auth event to all other tabs. */
+    broadcast: (event: AuthEvent) => void;
+    /** Register a listener for auth events from other tabs. Returns unsubscribe. */
+    onEvent: (callback: (event: AuthEvent) => void) => () => void;
+    /** Clean up channel and listeners. */
+    destroy: () => void;
+}
+/**
+ * Creates cross-tab auth synchronization.
+ *
+ * Primary: BroadcastChannel (modern browsers, 97%+ support).
+ * Fallback: localStorage `storage` events (legacy browsers).
+ *
+ * - Logout in Tab A → all other tabs clear session and redirect to login
+ * - Sign in in Tab A → other tabs can restore session from persistence
+ * - Token refresh in Tab A → other tabs pick up new token
+ *
+ * The channelFactory parameter enables testing without real BroadcastChannel.
+ * Pass `() => null` for environments where BroadcastChannel is unavailable.
+ */
+export declare function createCrossTabSync(channelFactory?: () => BroadcastChannel): CrossTabSync;
+//# sourceMappingURL=cross-tab.d.ts.map

package/dist/auth/cross-tab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-tab.d.ts","sourceRoot":"","sources":["../../src/auth/cross-tab.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAU5C,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACtC,gFAAgF;IAChF,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAC9D,sCAAsC;IACtC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAgBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,CAAC,EAAE,MAAM,gBAAgB,GACtC,YAAY,CA6Ed"}