@codingfactory/socialkit-vue 0.1.0

package/dist/services/api.js

@@ -0,0 +1,305 @@
+/**
+ * Configurable API service for SocialKit-powered frontends.
+ */
+import axios from 'axios';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isTransientServerError(status) {
+    return status === 502 || status === 503 || status === 504;
+}
+function isIdempotentMethod(method) {
+    const normalizedMethod = (method ?? 'get').toLowerCase();
+    return normalizedMethod === 'get' || normalizedMethod === 'head' || normalizedMethod === 'options';
+}
+function delay(ms) {
+    return new Promise((resolve) => { window.setTimeout(resolve, ms); });
+}
+function parseMissingPolicies(payload) {
+    if (!isRecord(payload)) {
+        return [];
+    }
+    const errors = payload.errors;
+    if (!isRecord(errors)) {
+        return [];
+    }
+    const missing = errors.missing;
+    if (!Array.isArray(missing)) {
+        return [];
+    }
+    const parsed = [];
+    for (const item of missing) {
+        if (!isRecord(item)) {
+            continue;
+        }
+        const policyId = item.policy_id;
+        const version = item.version;
+        if (typeof policyId !== 'string') {
+            continue;
+        }
+        const parsedVersion = typeof version === 'number'
+            ? version
+            : typeof version === 'string'
+                ? Number.parseInt(version, 10)
+                : Number.NaN;
+        if (!Number.isInteger(parsedVersion)) {
+            continue;
+        }
+        parsed.push({ policy_id: policyId, version: parsedVersion });
+    }
+    return parsed;
+}
+function isPoliciesPendingErrorPayload(payload) {
+    return isRecord(payload) && payload.code === 'POLICIES_PENDING';
+}
+function dedupeMissingPolicies(policies) {
+    const deduped = new Map();
+    for (const policy of policies) {
+        const existing = deduped.get(policy.policy_id);
+        if (!existing || policy.version > existing.version) {
+            deduped.set(policy.policy_id, policy);
+        }
+    }
+    return [...deduped.values()];
+}
+function cloneRequestConfig(config) {
+    return {
+        ...config,
+        headers: { ...config.headers }
+    };
+}
+function withAuthorizationHeader(config, token) {
+    return {
+        ...config,
+        headers: {
+            ...config.headers,
+            Authorization: `Bearer ${token}`
+        }
+    };
+}
+function createConfiguredClient(baseURL, timeout, client) {
+    if (client) {
+        client.defaults.baseURL = baseURL;
+        client.defaults.timeout = timeout;
+        client.defaults.headers.common.Accept = 'application/json';
+        client.defaults.headers.common['Content-Type'] = 'application/json';
+        client.defaults.withCredentials = false;
+        return client;
+    }
+    return axios.create({
+        baseURL,
+        timeout,
+        headers: {
+            'Content-Type': 'application/json',
+            Accept: 'application/json'
+        },
+        withCredentials: false
+    });
+}
+/** Create a configured API service instance. */
+export function createApiService(config) {
+    const { baseURL, tokenStorage, client, timeout = 30000, authPagePaths = ['/login', '/register'], loginPath = '/login', authFailureRedirectDelayMs = 1500, onResponseError, onAuthInvalidated, buildLoginRedirectUrl, maxServerRetries = 2, serverRetryBaseDelayMs = 500 } = config;
+    const clientInstance = createConfiguredClient(baseURL, timeout, client);
+    let pendingAuthRequests = [];
+    let authFailureRedirectTimeoutId = null;
+    let authFailureQueuedToken = null;
+    let policyAcceptancePromise = null;
+    function isPolicyAcceptRequest(url) {
+        return typeof url === 'string' && url.includes('/v1/policy/accept');
+    }
+    async function acceptMissingPolicies(missingPolicies) {
+        const policiesToAccept = dedupeMissingPolicies(missingPolicies);
+        if (policiesToAccept.length === 0) {
+            return false;
+        }
+        if (policyAcceptancePromise) {
+            return policyAcceptancePromise;
+        }
+        policyAcceptancePromise = (async () => {
+            try {
+                for (const policy of policiesToAccept) {
+                    await clientInstance.post('/v1/policy/accept', {
+                        policy_id: policy.policy_id,
+                        version: policy.version
+                    });
+                }
+                return true;
+            }
+            catch {
+                return false;
+            }
+            finally {
+                policyAcceptancePromise = null;
+            }
+        })();
+        return policyAcceptancePromise;
+    }
+    function capturePendingAuthRequest(reqConfig) {
+        pendingAuthRequests.push(cloneRequestConfig(reqConfig));
+    }
+    function cancelQueuedAuthFailureRedirect() {
+        if (authFailureRedirectTimeoutId === null) {
+            return;
+        }
+        window.clearTimeout(authFailureRedirectTimeoutId);
+        authFailureRedirectTimeoutId = null;
+        authFailureQueuedToken = null;
+    }
+    function queueAuthFailureRedirect() {
+        if (authFailureRedirectTimeoutId !== null) {
+            return;
+        }
+        authFailureQueuedToken = tokenStorage.getToken();
+        authFailureRedirectTimeoutId = window.setTimeout(() => {
+            authFailureRedirectTimeoutId = null;
+            const queuedToken = authFailureQueuedToken;
+            authFailureQueuedToken = null;
+            const currentToken = tokenStorage.getToken();
+            if (queuedToken !== null &&
+                currentToken !== null &&
+                currentToken !== queuedToken) {
+                return;
+            }
+            onAuthInvalidated?.();
+            tokenStorage.removeToken();
+            const currentPath = window.location.pathname;
+            if (authPagePaths.includes(currentPath)) {
+                return;
+            }
+            const redirectUrl = buildLoginRedirectUrl?.() ?? loginPath;
+            window.location.assign(redirectUrl);
+        }, authFailureRedirectDelayMs);
+    }
+    clientInstance.interceptors.request.use((reqConfig) => {
+        const token = tokenStorage.getToken();
+        if (token) {
+            reqConfig.headers.Authorization = `Bearer ${token}`;
+        }
+        const isFormData = typeof FormData !== 'undefined' && reqConfig.data instanceof FormData;
+        if (isFormData) {
+            delete reqConfig.headers['Content-Type'];
+            delete reqConfig.headers['content-type'];
+            reqConfig.transformRequest = [(data) => data];
+        }
+        return reqConfig;
+    }, (error) => Promise.reject(error));
+    clientInstance.interceptors.response.use((response) => response, async (error) => {
+        if (isTransientServerError(error.response?.status)) {
+            const originalRequest = error.config;
+            const retryCount = originalRequest?._serverRetryCount ?? 0;
+            if (originalRequest && retryCount < maxServerRetries && isIdempotentMethod(originalRequest.method)) {
+                originalRequest._serverRetryCount = retryCount + 1;
+                await delay(serverRetryBaseDelayMs * Math.pow(2, retryCount));
+                return clientInstance(originalRequest);
+            }
+        }
+        if (error.response?.status === 428) {
+            const originalRequest = error.config;
+            const requestUrl = originalRequest?.url;
+            const responsePayload = error.response?.data;
+            const missingPolicies = parseMissingPolicies(responsePayload);
+            const canAttemptPolicyAcceptance = Boolean(originalRequest &&
+                !originalRequest._policyRetry &&
+                !isPolicyAcceptRequest(requestUrl) &&
+                isPoliciesPendingErrorPayload(responsePayload) &&
+                missingPolicies.length > 0);
+            if (canAttemptPolicyAcceptance && originalRequest) {
+                originalRequest._policyRetry = true;
+                const accepted = await acceptMissingPolicies(missingPolicies);
+                if (accepted) {
+                    return clientInstance(originalRequest);
+                }
+            }
+        }
+        if (error.response?.status === 401) {
+            const originalRequest = error.config;
+            const requestUrl = originalRequest?.url;
+            const canAttemptRefresh = Boolean(originalRequest &&
+                !originalRequest._retry &&
+                !tokenStorage.shouldSkipAuth(requestUrl) &&
+                !tokenStorage.isRefreshTokenEndpoint(requestUrl));
+            if (canAttemptRefresh && originalRequest) {
+                originalRequest._retry = true;
+                const refreshedToken = await tokenStorage.tryRefreshToken();
+                if (refreshedToken) {
+                    const retryConfig = withAuthorizationHeader(originalRequest, refreshedToken);
+                    cancelQueuedAuthFailureRedirect();
+                    pendingAuthRequests = [];
+                    return clientInstance(retryConfig);
+                }
+            }
+            if (tokenStorage.wasTokenRotatedSince(originalRequest?.headers)) {
+                onResponseError?.(error);
+                return Promise.reject(error);
+            }
+            const shouldCapturePendingRequest = Boolean(originalRequest &&
+                !tokenStorage.shouldSkipAuth(requestUrl) &&
+                !tokenStorage.isRefreshTokenEndpoint(requestUrl));
+            if (shouldCapturePendingRequest && originalRequest) {
+                capturePendingAuthRequest(originalRequest);
+            }
+            queueAuthFailureRedirect();
+        }
+        onResponseError?.(error);
+        return Promise.reject(error);
+    });
+    return {
+        async get(url, reqConfig) {
+            const response = await clientInstance.get(url, reqConfig);
+            return response.data;
+        },
+        async post(url, data, reqConfig) {
+            const response = await clientInstance.post(url, data, reqConfig);
+            return response.data;
+        },
+        async put(url, data, reqConfig) {
+            const response = await clientInstance.put(url, data, reqConfig);
+            return response.data;
+        },
+        async patch(url, data, reqConfig) {
+            const response = await clientInstance.patch(url, data, reqConfig);
+            return response.data;
+        },
+        async delete(url, reqConfig) {
+            const response = await clientInstance.delete(url, reqConfig);
+            return response.data;
+        },
+        async postForm(url, form, reqConfig) {
+            const response = await clientInstance.post(url, form, reqConfig);
+            return response.data;
+        },
+        async postFormRaw(url, form, reqConfig) {
+            const response = await clientInstance.post(url, form, reqConfig);
+            return response;
+        },
+        markAuthRecoveryHandled() {
+            cancelQueuedAuthFailureRedirect();
+        },
+        hasPendingAuthRequest() {
+            return pendingAuthRequests.length > 0;
+        },
+        clearPendingAuthRequest() {
+            pendingAuthRequests = [];
+        },
+        async replayPendingAuthRequest(token) {
+            if (pendingAuthRequests.length === 0) {
+                return;
+            }
+            cancelQueuedAuthFailureRedirect();
+            const requestsToReplay = pendingAuthRequests.map(cloneRequestConfig);
+            pendingAuthRequests = [];
+            const results = await Promise.allSettled(requestsToReplay.map((request) => {
+                const retryConfig = withAuthorizationHeader({
+                    ...request,
+                    _retry: true
+                }, token);
+                return clientInstance(retryConfig);
+            }));
+            const firstRejection = results.find((result) => result.status === 'rejected');
+            if (firstRejection) {
+                throw firstRejection.reason;
+            }
+        }
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/services/api.js.map

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

package/dist/services/auth.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Configurable auth services and Axios auth-client wiring for
+ * SocialKit-powered frontends.
+ */
+import { type AxiosInstance } from 'axios';
+import type { TokenStorage } from '../utils/tokenStorage.js';
+import type { User } from '../types/user.js';
+/** Configuration for creating an auth service. */
+export interface AuthServiceConfig {
+    /** Base URL for API requests (e.g. '/api' or 'https://api.example.com/api'). */
+    baseURL: string;
+    /** Token storage instance for persisting auth tokens. */
+    tokenStorage: TokenStorage;
+    /** Request timeout in milliseconds (default: 30000). */
+    timeout?: number;
+}
+export interface ExtendedAuthServiceConfig extends AuthServiceConfig {
+    /** Optional existing Axios client to use instead of creating a dedicated one. */
+    client?: AxiosInstance;
+    /** Storage key for the client device identifier used by login/2FA endpoints. */
+    deviceIdStorageKey?: string;
+    /** Header name used for the device identifier (default: 'X-Device-Id'). */
+    deviceIdHeaderName?: string;
+    /** How forgot-password payloads should be derived from user input. */
+    forgotPasswordIdentifierStrategy?: 'email-only' | 'email-or-username';
+}
+/** Registration data shape. */
+export interface RegisterData {
+    handle: string;
+    name: string;
+    email: string;
+    password: string;
+    password_confirmation: string;
+}
+/** Password reset data shape. */
+export interface ResetPasswordData {
+    token: string;
+    email: string;
+    password: string;
+    password_confirmation: string;
+}
+/** Login response shape (user + optional token). */
+export interface LoginResponse {
+    user: User;
+    token?: string;
+}
+export interface AuthenticatedLoginResponse extends LoginResponse {
+    requires_2fa?: false;
+    challenge_id?: never;
+}
+export interface TwoFactorChallengeResponse {
+    requires_2fa: true;
+    challenge_id: string;
+}
+export interface AuthenticatedRegisterResponse extends LoginResponse {
+    requires_verification: false;
+}
+export interface VerificationRequiredRegisterResponse {
+    requires_verification: true;
+}
+export type AuthLoginResult = AuthenticatedLoginResponse | TwoFactorChallengeResponse;
+export type RegisterResponse = AuthenticatedRegisterResponse | VerificationRequiredRegisterResponse;
+/** Public auth service interface. */
+export interface AuthServiceInstance {
+    login(loginCredential: string, password: string, remember?: boolean): Promise<LoginResponse>;
+    register(data: RegisterData): Promise<LoginResponse>;
+    logout(): Promise<void>;
+    getUser(): Promise<User>;
+    forgotPassword(email: string): Promise<unknown>;
+    resetPassword(data: ResetPasswordData): Promise<unknown>;
+    hasToken(): boolean;
+    clearToken(): void;
+}
+export interface ExtendedAuthServiceInstance {
+    login(loginCredential: string, password: string, remember?: boolean): Promise<AuthLoginResult>;
+    register(data: RegisterData): Promise<RegisterResponse>;
+    verify2faChallenge(challengeId: string, code?: string, recoveryCode?: string, rememberDevice?: boolean, rememberSession?: boolean): Promise<AuthenticatedLoginResponse>;
+    logout(): Promise<void>;
+    getUser(): Promise<User>;
+    forgotPassword(identifier: string): Promise<unknown>;
+    resetPassword(data: ResetPasswordData): Promise<unknown>;
+    hasToken(): boolean;
+    clearToken(): void;
+}
+export interface TokenAuthClientConfig {
+    /** Existing Axios client to configure. Defaults to the shared axios export. */
+    client?: AxiosInstance;
+    /** Base URL for API requests. */
+    baseURL: string;
+    /** Token storage instance providing auth state and refresh behavior. */
+    tokenStorage: TokenStorage;
+    /** Request timeout in milliseconds (default: 30000). */
+    timeout?: number;
+    /** Delay before queued auth teardown/redirect executes (default: 1500). */
+    authFailureRedirectDelayMs?: number;
+    /** Paths considered auth pages; queued redirects will not re-target them. */
+    authPagePaths?: string[];
+    /** Build the redirect target when auth teardown occurs. */
+    buildLoginRedirectUrl?: () => string;
+    /** Called when auth teardown actually executes. */
+    onAuthInvalidated?: () => void;
+    /** Called for response errors that should surface globally. */
+    onResponseError?: (error: unknown) => void;
+    /** Suppress global error reporting for specific responses. */
+    shouldSuppressResponseError?: (error: unknown) => boolean;
+}
+export interface ConfiguredTokenAuthClient {
+    client: AxiosInstance;
+    setValidatingAuth(value: boolean): void;
+}
+/**
+ * Create a configured auth service instance.
+ *
+ * This is the conservative base service used by shared auth-store code.
+ */
+export declare function createAuthService(config: AuthServiceConfig): AuthServiceInstance;
+/**
+ * Create a richer auth workflow service for apps that use 2FA and device-id
+ * headers during login/verification flows.
+ */
+export declare function createExtendedAuthService(config: ExtendedAuthServiceConfig): ExtendedAuthServiceInstance;
+/**
+ * Configure a shared Axios client with generic token-auth request/response
+ * interceptors while preserving the raw Axios surface for host apps.
+ */
+export declare function configureTokenAuthClient(config: TokenAuthClientConfig): ConfiguredTokenAuthClient;
+//# sourceMappingURL=auth.d.ts.map

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

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