@codingfactory/socialkit-vue 0.1.0

package/dist/stores/auth.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Generic auth store factory for SocialKit-powered frontends.
+ *
+ * Use `createAuthStoreDefinition()` to produce a Pinia store definition
+ * that each site frontend can register with its own configuration.
+ */
+import type { ComputedRef, Ref } from 'vue';
+import type { Router } from 'vue-router';
+import type { AuthServiceInstance, LoginResponse, RegisterData } from '../services/auth.js';
+import type { ApiService } from '../services/api.js';
+import type { TokenStorage } from '../utils/tokenStorage.js';
+import type { User } from '../types/user.js';
+export interface AuthStoreStateRefs {
+    user: Ref<User | null>;
+    isAuthenticated: Ref<boolean>;
+    loading: Ref<boolean>;
+}
+export interface AuthStoreGetters {
+    currentUser: ComputedRef<User | null>;
+    isLoggedIn: ComputedRef<boolean>;
+    token: ComputedRef<string | null>;
+}
+export interface AuthStoreActions {
+    login: (loginCredential: string, password: string, redirectPath?: string, remember?: boolean) => Promise<LoginResponse>;
+    register: (data: RegisterData) => Promise<LoginResponse>;
+    logout: () => Promise<void>;
+    refreshSessionAndReplay: () => Promise<boolean>;
+    fetchUser: () => Promise<User | null>;
+    checkAuth: (forceValidation?: boolean) => Promise<void>;
+    setUser: (newUser: User) => void;
+    hasStoredToken: () => boolean;
+}
+export interface AuthStoreExtensionContext {
+    state: AuthStoreStateRefs;
+    getters: AuthStoreGetters;
+    actions: AuthStoreActions;
+    services: {
+        authService: AuthServiceInstance;
+        apiService: ApiService;
+        tokenStorage: TokenStorage;
+        router: Router;
+    };
+    config: {
+        storeId: string;
+        defaultLoginRedirect: string;
+    };
+    resolveSafeRedirectPath: (redirectPath?: string) => string;
+}
+export type AuthStoreExtension = Record<string, unknown>;
+/** Configuration for creating the auth store definition. */
+export interface AuthStoreConfig<TExtension extends AuthStoreExtension = Record<string, never>> {
+    /** Pinia store id (default: 'auth'). */
+    storeId?: string;
+    /** Auth service instance. */
+    authService: AuthServiceInstance;
+    /** API service instance (for pending auth request management). */
+    apiService: ApiService;
+    /** Token storage instance. */
+    tokenStorage: TokenStorage;
+    /** Vue Router instance. */
+    router: Router;
+    /** Default redirect path after login (default: '/'). */
+    defaultLoginRedirect?: string;
+    /** Extra Pinia store options (e.g. persist config from pinia-plugin-persistedstate). */
+    storeOptions?: Record<string, unknown>;
+    /** Hook called during logout to reset app-specific stores. */
+    onLogout?: () => Promise<void> | void;
+    /** Hook called after the user object is updated. */
+    onUserUpdated?: (prev: User | null, next: User) => void;
+    /** Callback to set the validating-auth flag on the auth service layer. */
+    setValidatingAuth?: (value: boolean) => void;
+    /** Add app-specific state, getters, and actions without forking the generic auth core. */
+    extend?: (context: AuthStoreExtensionContext) => TExtension;
+}
+export type AuthStoreReturn = ReturnType<ReturnType<typeof createAuthStoreDefinition>>;
+/** Create a Pinia auth store definition configured for a specific site. */
+export declare function createAuthStoreDefinition<TExtension extends AuthStoreExtension = Record<string, never>>(config: AuthStoreConfig<TExtension>): import("pinia").StoreDefinition<string, Pick<{
+    login: (loginCredential: string, password: string, redirectPath?: string, remember?: boolean) => Promise<LoginResponse>;
+    register: (data: RegisterData) => Promise<LoginResponse>;
+    logout: () => Promise<void>;
+    refreshSessionAndReplay: () => Promise<boolean>;
+    fetchUser: () => Promise<User | null>;
+    checkAuth: (forceValidation?: boolean) => Promise<void>;
+    setUser: (newUser: User) => void;
+    hasStoredToken: () => boolean;
+    currentUser: ComputedRef<User | null>;
+    isLoggedIn: ComputedRef<boolean>;
+    token: ComputedRef<string | null>;
+    user: ComputedRef<{
+        id: string;
+        name: string;
+        email: string;
+        avatar?: (string | Record<string, unknown> | null) | undefined;
+        avatar_url?: string | null | undefined;
+        cover_photo?: string | null | undefined;
+        handle?: string | undefined;
+        role: "admin" | "moderator" | "user";
+        tenant_id?: string | undefined;
+        roles?: string[] | undefined;
+        permissions?: string[] | undefined;
+        capabilities?: Record<string, boolean> | undefined;
+        last_login_at?: string | undefined;
+        created_at?: string | undefined;
+        status?: "active" | "suspended" | "banned" | undefined;
+        model_type?: string | undefined;
+    } | null>;
+    isAuthenticated: ComputedRef<boolean>;
+    loading: ComputedRef<boolean>;
+}, never>, Pick<{
+    login: (loginCredential: string, password: string, redirectPath?: string, remember?: boolean) => Promise<LoginResponse>;
+    register: (data: RegisterData) => Promise<LoginResponse>;
+    logout: () => Promise<void>;
+    refreshSessionAndReplay: () => Promise<boolean>;
+    fetchUser: () => Promise<User | null>;
+    checkAuth: (forceValidation?: boolean) => Promise<void>;
+    setUser: (newUser: User) => void;
+    hasStoredToken: () => boolean;
+    currentUser: ComputedRef<User | null>;
+    isLoggedIn: ComputedRef<boolean>;
+    token: ComputedRef<string | null>;
+    user: ComputedRef<{
+        id: string;
+        name: string;
+        email: string;
+        avatar?: (string | Record<string, unknown> | null) | undefined;
+        avatar_url?: string | null | undefined;
+        cover_photo?: string | null | undefined;
+        handle?: string | undefined;
+        role: "admin" | "moderator" | "user";
+        tenant_id?: string | undefined;
+        roles?: string[] | undefined;
+        permissions?: string[] | undefined;
+        capabilities?: Record<string, boolean> | undefined;
+        last_login_at?: string | undefined;
+        created_at?: string | undefined;
+        status?: "active" | "suspended" | "banned" | undefined;
+        model_type?: string | undefined;
+    } | null>;
+    isAuthenticated: ComputedRef<boolean>;
+    loading: ComputedRef<boolean>;
+}, "user" | "token" | "currentUser" | "isLoggedIn" | "isAuthenticated" | "loading">, Pick<{
+    login: (loginCredential: string, password: string, redirectPath?: string, remember?: boolean) => Promise<LoginResponse>;
+    register: (data: RegisterData) => Promise<LoginResponse>;
+    logout: () => Promise<void>;
+    refreshSessionAndReplay: () => Promise<boolean>;
+    fetchUser: () => Promise<User | null>;
+    checkAuth: (forceValidation?: boolean) => Promise<void>;
+    setUser: (newUser: User) => void;
+    hasStoredToken: () => boolean;
+    currentUser: ComputedRef<User | null>;
+    isLoggedIn: ComputedRef<boolean>;
+    token: ComputedRef<string | null>;
+    user: ComputedRef<{
+        id: string;
+        name: string;
+        email: string;
+        avatar?: (string | Record<string, unknown> | null) | undefined;
+        avatar_url?: string | null | undefined;
+        cover_photo?: string | null | undefined;
+        handle?: string | undefined;
+        role: "admin" | "moderator" | "user";
+        tenant_id?: string | undefined;
+        roles?: string[] | undefined;
+        permissions?: string[] | undefined;
+        capabilities?: Record<string, boolean> | undefined;
+        last_login_at?: string | undefined;
+        created_at?: string | undefined;
+        status?: "active" | "suspended" | "banned" | undefined;
+        model_type?: string | undefined;
+    } | null>;
+    isAuthenticated: ComputedRef<boolean>;
+    loading: ComputedRef<boolean>;
+}, "login" | "register" | "logout" | "refreshSessionAndReplay" | "fetchUser" | "checkAuth" | "setUser" | "hasStoredToken">>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/stores/auth.d.ts.map

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

package/dist/stores/auth.js

@@ -0,0 +1,262 @@
+/**
+ * Generic auth store factory for SocialKit-powered frontends.
+ *
+ * Use `createAuthStoreDefinition()` to produce a Pinia store definition
+ * that each site frontend can register with its own configuration.
+ */
+import { defineStore } from 'pinia';
+import { ref, computed } from 'vue';
+/** Create a Pinia auth store definition configured for a specific site. */
+export function createAuthStoreDefinition(config) {
+    const { storeId = 'auth', authService, apiService, tokenStorage, router, defaultLoginRedirect = '/', storeOptions = {}, onLogout, onUserUpdated, setValidatingAuth, extend } = config;
+    const EXTERNAL_PROTOCOL_PATTERN = /^[a-z][a-z\d+\-.]*:/i;
+    return defineStore(storeId, () => {
+        // State
+        const user = ref(null);
+        const isAuthenticated = ref(false);
+        const loading = ref(false);
+        // Getters
+        const currentUser = computed(() => user.value);
+        const isLoggedIn = computed(() => isAuthenticated.value);
+        const token = computed(() => tokenStorage.getToken());
+        function resolveSafeRedirectPath(redirectPath) {
+            if (!redirectPath) {
+                return defaultLoginRedirect;
+            }
+            const trimmed = redirectPath.trim();
+            if (trimmed === '') {
+                return defaultLoginRedirect;
+            }
+            if (EXTERNAL_PROTOCOL_PATTERN.test(trimmed)) {
+                return defaultLoginRedirect;
+            }
+            if (!trimmed.startsWith('/') || trimmed.startsWith('//')) {
+                return defaultLoginRedirect;
+            }
+            return trimmed;
+        }
+        // Actions
+        async function login(loginCredential, password, redirectPath, remember = false) {
+            loading.value = true;
+            try {
+                const response = await authService.login(loginCredential, password, remember);
+                user.value = response.user;
+                isAuthenticated.value = true;
+                await fetchUser();
+                const destination = resolveSafeRedirectPath(redirectPath);
+                router.push(destination);
+                return response;
+            }
+            catch (error) {
+                isAuthenticated.value = false;
+                user.value = null;
+                throw error;
+            }
+            finally {
+                loading.value = false;
+            }
+        }
+        async function register(data) {
+            loading.value = true;
+            try {
+                const response = await authService.register(data);
+                user.value = response.user;
+                isAuthenticated.value = true;
+                await fetchUser();
+                router.push(defaultLoginRedirect);
+                return response;
+            }
+            catch (error) {
+                isAuthenticated.value = false;
+                user.value = null;
+                throw error;
+            }
+            finally {
+                loading.value = false;
+            }
+        }
+        async function logout() {
+            loading.value = true;
+            try {
+                await authService.logout();
+            }
+            finally {
+                apiService.clearPendingAuthRequest();
+                if (onLogout) {
+                    try {
+                        await onLogout();
+                    }
+                    catch {
+                        // Swallow store-reset errors during logout
+                    }
+                }
+                user.value = null;
+                isAuthenticated.value = false;
+                loading.value = false;
+                const currentPath = window.location.pathname;
+                if (currentPath !== '/login' && currentPath !== '/register') {
+                    router.push('/login');
+                }
+            }
+        }
+        async function refreshSessionAndReplay() {
+            const refreshedToken = await tokenStorage.tryRefreshToken();
+            if (!refreshedToken) {
+                apiService.clearPendingAuthRequest();
+                user.value = null;
+                isAuthenticated.value = false;
+                tokenStorage.removeToken();
+                return false;
+            }
+            try {
+                await fetchUser();
+            }
+            catch {
+                apiService.clearPendingAuthRequest();
+                user.value = null;
+                isAuthenticated.value = false;
+                tokenStorage.removeToken();
+                return false;
+            }
+            apiService.markAuthRecoveryHandled();
+            if (apiService.hasPendingAuthRequest()) {
+                try {
+                    await apiService.replayPendingAuthRequest(refreshedToken);
+                }
+                catch {
+                    // Keep session; callers can retry replay manually
+                }
+            }
+            return true;
+        }
+        async function fetchUser() {
+            loading.value = true;
+            try {
+                const prev = user.value ? { ...user.value } : null;
+                const next = await authService.getUser();
+                user.value = { ...next };
+                isAuthenticated.value = true;
+                if (onUserUpdated) {
+                    onUserUpdated(prev, next);
+                }
+                return user.value;
+            }
+            catch (error) {
+                isAuthenticated.value = false;
+                user.value = null;
+                throw error;
+            }
+            finally {
+                loading.value = false;
+            }
+        }
+        async function checkAuth(forceValidation = false) {
+            const storedToken = tokenStorage.getToken();
+            if (!storedToken) {
+                isAuthenticated.value = false;
+                user.value = null;
+                return;
+            }
+            if (!forceValidation && isAuthenticated.value && user.value) {
+                return;
+            }
+            if (setValidatingAuth) {
+                setValidatingAuth(true);
+            }
+            try {
+                await fetchUser();
+            }
+            catch {
+                isAuthenticated.value = false;
+                user.value = null;
+                tokenStorage.removeToken();
+            }
+            finally {
+                if (setValidatingAuth) {
+                    setValidatingAuth(false);
+                }
+            }
+        }
+        function setUser(newUser) {
+            const prev = user.value ? { ...user.value } : null;
+            user.value = { ...newUser };
+            isAuthenticated.value = true;
+            if (onUserUpdated) {
+                onUserUpdated(prev, newUser);
+            }
+        }
+        function hasStoredToken() {
+            const storedToken = tokenStorage.getToken();
+            if (storedToken === null) {
+                isAuthenticated.value = false;
+                user.value = null;
+                return false;
+            }
+            return true;
+        }
+        const baseState = {
+            user,
+            isAuthenticated,
+            loading
+        };
+        const baseGetters = {
+            currentUser,
+            isLoggedIn,
+            token
+        };
+        const baseActions = {
+            login,
+            register,
+            logout,
+            refreshSessionAndReplay,
+            fetchUser,
+            checkAuth,
+            setUser,
+            hasStoredToken
+        };
+        const baseStore = {
+            // State (as computed refs for readonly exposure)
+            user: computed(() => user.value),
+            isAuthenticated: computed(() => isAuthenticated.value && token.value !== null),
+            loading: computed(() => loading.value),
+            // Getters
+            ...baseGetters,
+            // Actions
+            ...baseActions
+        };
+        const extensionContext = {
+            state: baseState,
+            getters: baseGetters,
+            actions: baseActions,
+            services: {
+                authService,
+                apiService,
+                tokenStorage,
+                router
+            },
+            config: {
+                storeId,
+                defaultLoginRedirect
+            },
+            resolveSafeRedirectPath
+        };
+        const extension = extend?.(extensionContext);
+        if (extension) {
+            for (const key of Object.keys(extension)) {
+                if (key in baseStore) {
+                    throw new Error(`Auth store extension key "${key}" conflicts with the shared auth store surface.`);
+                }
+            }
+        }
+        if (extension) {
+            return {
+                ...baseStore,
+                ...extension
+            };
+        }
+        return {
+            ...baseStore
+        };
+    }, storeOptions);
+}
+//# sourceMappingURL=auth.js.map

package/dist/stores/auth.js.map

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

package/dist/types/api.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Core type definitions for SocialKit API services.
+ *
+ * These types are generic and shared across all SocialKit-powered frontends.
+ */
+/** Standard API response wrapper. */
+export interface ApiResponse<T> {
+    data: T;
+    meta?: {
+        current_page?: number;
+        total?: number;
+        per_page?: number;
+        last_page?: number;
+        next_cursor?: string;
+        prev_cursor?: string;
+        has_more?: boolean;
+    };
+    message?: string;
+    status?: number;
+}
+/** Paginated response shape. */
+export interface PaginatedResponse<T> {
+    items: T[];
+    total: number;
+    per_page: number;
+    current_page: number;
+    last_page: number;
+    next_cursor?: string;
+    prev_cursor?: string;
+}
+/** API error shape. */
+export interface ApiError {
+    message: string;
+    code?: string;
+    status?: number;
+    details?: Record<string, unknown>;
+}
+/** Upload progress event. */
+export interface UploadProgressEvent {
+    loaded: number;
+    total?: number;
+    progress?: number;
+}
+/** Request configuration accepted by ApiService methods. */
+export interface RequestConfig {
+    headers?: Record<string, string>;
+    params?: Record<string, string | number | boolean>;
+    timeout?: number;
+    onUploadProgress?: (progressEvent: UploadProgressEvent) => void;
+    signal?: AbortSignal;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/types/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qCAAqC;AACrC,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAA;IACP,IAAI,CAAC,EAAE;QACL,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;KACnB,CAAA;IACD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,gCAAgC;AAChC,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,uBAAuB;AACvB,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED,6BAA6B;AAC7B,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gBAAgB,CAAC,EAAE,CAAC,aAAa,EAAE,mBAAmB,KAAK,IAAI,CAAA;IAC/D,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB"}

package/dist/types/api.js

@@ -0,0 +1,7 @@
+/**
+ * Core type definitions for SocialKit API services.
+ *
+ * These types are generic and shared across all SocialKit-powered frontends.
+ */
+export {};
+//# sourceMappingURL=api.js.map

package/dist/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/types/user.d.ts

@@ -0,0 +1,42 @@
+/**
+ * User type definitions shared across SocialKit frontends.
+ */
+/** Base user type used by the auth system. */
+export interface User {
+    id: string;
+    name: string;
+    email: string;
+    avatar?: string | Record<string, unknown> | null;
+    avatar_url?: string | null;
+    cover_photo?: string | null;
+    handle?: string;
+    role: 'admin' | 'moderator' | 'user';
+    tenant_id?: string;
+    roles?: string[];
+    permissions?: string[];
+    capabilities?: Record<string, boolean>;
+    last_login_at?: string;
+    created_at?: string;
+    status?: 'active' | 'suspended' | 'banned';
+    model_type?: string;
+}
+/** Identity user type from the identity service. */
+export interface IdentityUser {
+    id: string;
+    handle?: string;
+    name: string;
+    avatar?: string | null;
+    avatar_url?: string | null;
+    cover_photo?: string | null;
+    bio?: string | null;
+    email?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+/** Type guard for User. */
+export declare function isUser(obj: unknown): obj is User;
+/** Type guard for IdentityUser. */
+export declare function isIdentityUser(obj: unknown): obj is IdentityUser;
+/** Convert an IdentityUser to the base User type. */
+export declare function identityUserToUser(identity: IdentityUser, role?: 'admin' | 'moderator' | 'user'): User;
+//# sourceMappingURL=user.d.ts.map

package/dist/types/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/types/user.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8CAA8C;AAC9C,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAChD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,MAAM,CAAA;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACtC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAA;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,2BAA2B;AAC3B,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,IAAI,CAShD;AAED,mCAAmC;AACnC,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,YAAY,CAOhE;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,IAAI,GAAE,OAAO,GAAG,WAAW,GAAG,MAAe,GAC5C,IAAI,CA6BN"}

package/dist/types/user.js

@@ -0,0 +1,45 @@
+/**
+ * User type definitions shared across SocialKit frontends.
+ */
+/** Type guard for User. */
+export function isUser(obj) {
+    return (obj !== null &&
+        typeof obj === 'object' &&
+        'id' in obj &&
+        'name' in obj &&
+        'email' in obj &&
+        'role' in obj);
+}
+/** Type guard for IdentityUser. */
+export function isIdentityUser(obj) {
+    return (obj !== null &&
+        typeof obj === 'object' &&
+        'id' in obj &&
+        'name' in obj);
+}
+/** Convert an IdentityUser to the base User type. */
+export function identityUserToUser(identity, role = 'user') {
+    const user = {
+        id: identity.id,
+        name: identity.name,
+        email: identity.email ?? '',
+        role
+    };
+    if (identity.avatar !== null && identity.avatar !== undefined) {
+        user.avatar = identity.avatar;
+    }
+    if (identity.avatar_url !== null && identity.avatar_url !== undefined) {
+        user.avatar_url = identity.avatar_url;
+    }
+    if (identity.cover_photo !== null && identity.cover_photo !== undefined) {
+        user.cover_photo = identity.cover_photo;
+    }
+    if (identity.handle !== undefined) {
+        user.handle = identity.handle;
+    }
+    if (identity.created_at !== undefined) {
+        user.created_at = identity.created_at;
+    }
+    return user;
+}
+//# sourceMappingURL=user.js.map

package/dist/types/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/types/user.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoCH,2BAA2B;AAC3B,MAAM,UAAU,MAAM,CAAC,GAAY;IACjC,OAAO,CACL,GAAG,KAAK,IAAI;QACZ,OAAO,GAAG,KAAK,QAAQ;QACvB,IAAI,IAAI,GAAG;QACX,MAAM,IAAI,GAAG;QACb,OAAO,IAAI,GAAG;QACd,MAAM,IAAI,GAAG,CACd,CAAA;AACH,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,OAAO,CACL,GAAG,KAAK,IAAI;QACZ,OAAO,GAAG,KAAK,QAAQ;QACvB,IAAI,IAAI,GAAG;QACX,MAAM,IAAI,GAAG,CACd,CAAA;AACH,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,kBAAkB,CAChC,QAAsB,EACtB,OAAuC,MAAM;IAE7C,MAAM,IAAI,GAAS;QACjB,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE;QAC3B,IAAI;KACL,CAAA;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9D,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAA;IAC/B,CAAC;IAED,IAAI,QAAQ,CAAC,UAAU,KAAK,IAAI,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACtE,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAA;IACvC,CAAC;IAED,IAAI,QAAQ,CAAC,WAAW,KAAK,IAAI,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACxE,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAA;IACzC,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAA;IAC/B,CAAC;IAED,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAA;IACvC,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/utils/tokenStorage.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Token storage utility for SocialKit-powered frontends.
+ *
+ * Tokens are cached in memory and persisted to a configurable browser storage
+ * backend. Use `createTokenStorage()` to get a configured instance.
+ */
+/** Configuration for creating a token storage instance. */
+export interface TokenStorageConfig {
+    /** Storage key for the token (default: 'auth_token'). */
+    storageKey?: string;
+    /** API base URL used by the refresh client (default: '/api'). */
+    apiBaseUrl?: string;
+    /** Endpoints to call when refreshing a token (default: ['/v1/auth/refresh-token']). */
+    refreshEndpoints?: string[];
+    /** Endpoints where the Authorization header should NOT be sent. */
+    anonymousEndpoints?: string[];
+    /** When true, persist in localStorage and share across tabs; otherwise sessionStorage. */
+    shareSessions?: boolean;
+}
+/** Public token storage interface. */
+export interface TokenStorage {
+    getToken(): string | null;
+    setToken(token: string): void;
+    removeToken(): void;
+    hasToken(): boolean;
+    shouldSkipAuth(url: string | undefined): boolean;
+    isRefreshTokenEndpoint(url: string | undefined): boolean;
+    tryRefreshToken(): Promise<string | null>;
+    wasTokenRotatedSince(requestAuthHeaderOrHeaders: unknown): boolean;
+}
+/**
+ * Extract a token string from various API response shapes.
+ *
+ * Handles:
+ * - `{ token: string }`
+ * - `{ data: { token: string } }`
+ */
+export declare function extractTokenFromResponse(payload: unknown): string | undefined;
+/** Create a configured token storage instance. */
+export declare function createTokenStorage(config?: TokenStorageConfig): TokenStorage;
+//# sourceMappingURL=tokenStorage.d.ts.map