@codingfactory/socialkit-vue 0.1.0

package/dist/utils/tokenStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenStorage.d.ts","sourceRoot":"","sources":["../../src/utils/tokenStorage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,mEAAmE;IACnE,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC7B,0FAA0F;IAC1F,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,QAAQ,IAAI,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,WAAW,IAAI,IAAI,CAAA;IACnB,QAAQ,IAAI,OAAO,CAAA;IACnB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;IAChD,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;IACxD,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACzC,oBAAoB,CAAC,0BAA0B,EAAE,OAAO,GAAG,OAAO,CAAA;CACnE;AAyID;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAiB7E;AAED,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,kBAAuB,GAAG,YAAY,CAoMhF"}

package/dist/utils/tokenStorage.js

@@ -0,0 +1,300 @@
+/**
+ * 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.
+ */
+import axios from 'axios';
+const DEFAULT_STORAGE_KEY = 'auth_token';
+const DEFAULT_REFRESH_ENDPOINTS = ['/v1/auth/refresh-token'];
+const DEFAULT_ANONYMOUS_ENDPOINTS = [
+    '/sanctum/csrf-cookie',
+    '/v1/auth/login',
+    '/v1/auth/register',
+    '/v1/auth/forgot-password',
+    '/v1/auth/reset-password'
+];
+function normalizeStoredToken(stored) {
+    if (typeof stored === 'string' && stored.length > 0) {
+        return stored;
+    }
+    return undefined;
+}
+function getBrowserStorage(kind) {
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    try {
+        return kind === 'local' ? window.localStorage : window.sessionStorage;
+    }
+    catch {
+        return null;
+    }
+}
+function resolveStoragePair(shareSessions) {
+    if (shareSessions) {
+        return {
+            primary: getBrowserStorage('local'),
+            secondary: getBrowserStorage('session')
+        };
+    }
+    return {
+        primary: getBrowserStorage('session'),
+        secondary: getBrowserStorage('local')
+    };
+}
+function readStorageToken(storage, storageKey) {
+    if (storage === null) {
+        return undefined;
+    }
+    try {
+        const stored = storage.getItem(storageKey);
+        return normalizeStoredToken(stored);
+    }
+    catch {
+        return undefined;
+    }
+}
+function writeStorageToken(storage, storageKey, token) {
+    if (storage === null) {
+        return;
+    }
+    try {
+        storage.setItem(storageKey, token);
+    }
+    catch {
+        // Storage full or unavailable — token still works for this session via memory.
+    }
+}
+function removeStorageToken(storage, storageKey) {
+    if (storage === null) {
+        return;
+    }
+    try {
+        storage.removeItem(storageKey);
+    }
+    catch {
+        // Storage unavailable — ignore.
+    }
+}
+function isObjectRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function extractAuthorizationHeaderValue(requestAuthHeaderOrHeaders) {
+    if (typeof requestAuthHeaderOrHeaders === 'string') {
+        return requestAuthHeaderOrHeaders;
+    }
+    if (!isObjectRecord(requestAuthHeaderOrHeaders)) {
+        return null;
+    }
+    const maybeGet = requestAuthHeaderOrHeaders.get;
+    if (typeof maybeGet === 'function') {
+        const uppercaseValue = maybeGet.call(requestAuthHeaderOrHeaders, 'Authorization');
+        if (typeof uppercaseValue === 'string' && uppercaseValue.length > 0) {
+            return uppercaseValue;
+        }
+        const lowercaseValue = maybeGet.call(requestAuthHeaderOrHeaders, 'authorization');
+        if (typeof lowercaseValue === 'string' && lowercaseValue.length > 0) {
+            return lowercaseValue;
+        }
+    }
+    const directUppercase = requestAuthHeaderOrHeaders.Authorization;
+    if (typeof directUppercase === 'string' && directUppercase.length > 0) {
+        return directUppercase;
+    }
+    const directLowercase = requestAuthHeaderOrHeaders.authorization;
+    if (typeof directLowercase === 'string' && directLowercase.length > 0) {
+        return directLowercase;
+    }
+    for (const [key, value] of Object.entries(requestAuthHeaderOrHeaders)) {
+        if (key.toLowerCase() !== 'authorization') {
+            continue;
+        }
+        if (typeof value === 'string' && value.length > 0) {
+            return value;
+        }
+    }
+    return null;
+}
+/**
+ * Extract a token string from various API response shapes.
+ *
+ * Handles:
+ * - `{ token: string }`
+ * - `{ data: { token: string } }`
+ */
+export function extractTokenFromResponse(payload) {
+    if (!payload || typeof payload !== 'object') {
+        return undefined;
+    }
+    if ('token' in payload) {
+        const token = payload.token;
+        if (typeof token === 'string' && token.length > 0) {
+            return token;
+        }
+    }
+    if ('data' in payload) {
+        return extractTokenFromResponse(payload.data);
+    }
+    return undefined;
+}
+/** Create a configured token storage instance. */
+export function createTokenStorage(config = {}) {
+    const storageKey = config.storageKey ?? DEFAULT_STORAGE_KEY;
+    const refreshEndpoints = config.refreshEndpoints ?? DEFAULT_REFRESH_ENDPOINTS;
+    const anonymousEndpoints = config.anonymousEndpoints ?? DEFAULT_ANONYMOUS_ENDPOINTS;
+    const apiBaseUrl = config.apiBaseUrl ?? '/api';
+    const shareSessions = config.shareSessions ?? false;
+    const storagePair = resolveStoragePair(shareSessions);
+    let inMemoryToken;
+    let refreshPromise = null;
+    function readPersistedToken() {
+        const primaryToken = readStorageToken(storagePair.primary, storageKey);
+        const secondaryToken = readStorageToken(storagePair.secondary, storageKey);
+        if (secondaryToken !== undefined) {
+            if (primaryToken === undefined) {
+                writeStorageToken(storagePair.primary, storageKey, secondaryToken);
+            }
+            removeStorageToken(storagePair.secondary, storageKey);
+        }
+        return primaryToken ?? secondaryToken;
+    }
+    function persistToken(token) {
+        writeStorageToken(storagePair.primary, storageKey, token);
+        removeStorageToken(storagePair.secondary, storageKey);
+    }
+    function clearPersistedTokens() {
+        removeStorageToken(getBrowserStorage('local'), storageKey);
+        removeStorageToken(getBrowserStorage('session'), storageKey);
+    }
+    function syncInMemoryTokenFromStorage() {
+        inMemoryToken = readPersistedToken();
+    }
+    inMemoryToken = readPersistedToken();
+    if (typeof window !== 'undefined') {
+        window.addEventListener('storage', (event) => {
+            const localStorageRef = getBrowserStorage('local');
+            const sessionStorageRef = getBrowserStorage('session');
+            if (event.storageArea &&
+                event.storageArea !== localStorageRef &&
+                event.storageArea !== sessionStorageRef) {
+                return;
+            }
+            if (event.key === storageKey) {
+                inMemoryToken = normalizeStoredToken(event.newValue);
+                if (inMemoryToken === undefined) {
+                    clearPersistedTokens();
+                }
+                return;
+            }
+            if (event.key !== null) {
+                return;
+            }
+            syncInMemoryTokenFromStorage();
+        });
+    }
+    const refreshClient = axios.create({
+        baseURL: apiBaseUrl,
+        timeout: 30000,
+        headers: {
+            'Content-Type': 'application/json',
+            Accept: 'application/json'
+        },
+        withCredentials: false
+    });
+    function getToken() {
+        if (inMemoryToken !== undefined) {
+            return inMemoryToken;
+        }
+        const persistedToken = readPersistedToken();
+        if (persistedToken !== undefined) {
+            inMemoryToken = persistedToken;
+            return persistedToken;
+        }
+        return null;
+    }
+    function setToken(token) {
+        inMemoryToken = token;
+        persistToken(token);
+    }
+    function removeToken() {
+        inMemoryToken = undefined;
+        clearPersistedTokens();
+    }
+    function hasToken() {
+        return getToken() !== null;
+    }
+    function shouldSkipAuth(url) {
+        if (!url) {
+            return false;
+        }
+        return anonymousEndpoints.some((endpoint) => url.includes(endpoint));
+    }
+    function isRefreshTokenEndpoint(url) {
+        if (!url) {
+            return false;
+        }
+        return refreshEndpoints.some((endpoint) => url.includes(endpoint));
+    }
+    async function requestTokenRefresh() {
+        const existingToken = getToken();
+        if (!existingToken) {
+            return null;
+        }
+        for (const endpoint of refreshEndpoints) {
+            try {
+                const response = await refreshClient.post(endpoint, {}, {
+                    headers: {
+                        Authorization: `Bearer ${existingToken}`
+                    }
+                });
+                const refreshedToken = extractTokenFromResponse(response.data);
+                if (refreshedToken) {
+                    setToken(refreshedToken);
+                    return refreshedToken;
+                }
+            }
+            catch {
+                // Try the next known refresh endpoint.
+            }
+        }
+        const latestPersistedToken = readPersistedToken();
+        if (latestPersistedToken && latestPersistedToken !== existingToken) {
+            inMemoryToken = latestPersistedToken;
+            return latestPersistedToken;
+        }
+        return null;
+    }
+    async function tryRefreshToken() {
+        if (refreshPromise) {
+            return refreshPromise;
+        }
+        refreshPromise = requestTokenRefresh();
+        try {
+            return await refreshPromise;
+        }
+        finally {
+            refreshPromise = null;
+        }
+    }
+    function wasTokenRotatedSince(requestAuthHeaderOrHeaders) {
+        const requestAuthHeader = extractAuthorizationHeaderValue(requestAuthHeaderOrHeaders);
+        if (requestAuthHeader === null || !requestAuthHeader.startsWith('Bearer ')) {
+            return false;
+        }
+        const requestToken = requestAuthHeader.slice(7);
+        const currentToken = getToken();
+        return requestToken.length > 0 && currentToken !== null && currentToken !== requestToken;
+    }
+    return {
+        getToken,
+        setToken,
+        removeToken,
+        hasToken,
+        shouldSkipAuth,
+        isRefreshTokenEndpoint,
+        tryRefreshToken,
+        wasTokenRotatedSince
+    };
+}
+//# sourceMappingURL=tokenStorage.js.map

package/dist/utils/tokenStorage.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@codingfactory/socialkit-vue",
+  "version": "0.1.0",
+  "description": "Shared Vue 3 utilities for SocialKit-powered frontends",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "axios": "^1.6.0",
+    "pinia": "^3.0.0",
+    "vue": "^3.4.0",
+    "vue-router": "^4.3.0"
+  },
+  "devDependencies": {
+    "axios": "^1.7.0",
+    "pinia": "^3.0.0",
+    "typescript": "~5.7.0",
+    "vue": "^3.5.0",
+    "vue-router": "^4.5.0"
+  },
+  "license": "UNLICENSED",
+  "private": false
+}

package/src/composables/useAuth.ts

@@ -0,0 +1,164 @@
+/**
+ * Composable for common auth operations.
+ *
+ * This is a thin convenience wrapper that adds local loading/error state
+ * on top of an auth service instance.
+ */
+
+import { ref, computed, type Ref, type ComputedRef } from 'vue'
+import type { AuthServiceInstance, RegisterData, ResetPasswordData } from '../services/auth.js'
+import type { User } from '../types/user.js'
+
+function isAxiosError(error: unknown): error is {
+  response?: {
+    status?: number
+    data?: {
+      message?: string
+      errors?: Record<string, string[]>
+    }
+  }
+} {
+  return error !== null && typeof error === 'object' && 'response' in error
+}
+
+function extractForgotPasswordValidationMessage(error: unknown): string | null {
+  if (!isAxiosError(error) || error.response?.status !== 422) {
+    return null
+  }
+
+  const emailErrors = error.response.data?.errors?.email
+  const usernameErrors = error.response.data?.errors?.username
+  const identifierErrors = error.response.data?.errors?.identifier
+
+  return emailErrors?.[0] ?? usernameErrors?.[0] ?? identifierErrors?.[0] ?? null
+}
+
+export interface UseAuthReturn {
+  user: ComputedRef<User | null>
+  loading: Ref<boolean>
+  error: Ref<string | null>
+  login(credential: string, password: string): Promise<unknown>
+  register(data: RegisterData): Promise<unknown>
+  logout(): Promise<void>
+  forgotPassword(email: string): Promise<unknown>
+  resetPassword(data: ResetPasswordData): Promise<unknown>
+}
+
+/**
+ * Create the useAuth composable bound to a specific auth service and user ref.
+ *
+ * Call `makeUseAuth()` once during app bootstrap, then use the returned
+ * composable in your components.
+ */
+export function makeUseAuth(
+  authService: AuthServiceInstance,
+  currentUser: Ref<User | null>
+): () => UseAuthReturn {
+  return function useAuth(): UseAuthReturn {
+    const loading = ref(false)
+    const error = ref<string | null>(null)
+
+    const user = computed(() => currentUser.value)
+
+    const login = async (credential: string, password: string): Promise<unknown> => {
+      loading.value = true
+      error.value = null
+
+      try {
+        const response = await authService.login(credential, password)
+        return response
+      } catch (err) {
+        if (isAxiosError(err)) {
+          error.value = err.response?.data?.message ?? 'Login failed'
+        } else {
+          error.value = 'Login failed'
+        }
+        throw err
+      } finally {
+        loading.value = false
+      }
+    }
+
+    const register = async (data: RegisterData): Promise<unknown> => {
+      loading.value = true
+      error.value = null
+
+      try {
+        const response = await authService.register(data)
+        return response
+      } catch (err) {
+        if (isAxiosError(err)) {
+          error.value = err.response?.data?.message ?? 'Registration failed'
+        } else {
+          error.value = 'Registration failed'
+        }
+        throw err
+      } finally {
+        loading.value = false
+      }
+    }
+
+    const logout = async (): Promise<void> => {
+      loading.value = true
+
+      try {
+        await authService.logout()
+      } finally {
+        loading.value = false
+      }
+    }
+
+    const forgotPassword = async (email: string): Promise<unknown> => {
+      loading.value = true
+      error.value = null
+
+      try {
+        const response = await authService.forgotPassword(email)
+        error.value = null
+        return response
+      } catch (err) {
+        const validationMessage = extractForgotPasswordValidationMessage(err)
+        if (validationMessage !== null) {
+          error.value = validationMessage
+        } else if (isAxiosError(err)) {
+          error.value = err.response?.data?.message ?? 'Failed to send reset link'
+        } else {
+          error.value = 'Failed to send reset link'
+        }
+        throw err
+      } finally {
+        loading.value = false
+      }
+    }
+
+    const resetPassword = async (data: ResetPasswordData): Promise<unknown> => {
+      loading.value = true
+      error.value = null
+
+      try {
+        const response = await authService.resetPassword(data)
+        return response
+      } catch (err) {
+        if (isAxiosError(err)) {
+          error.value = err.response?.data?.message ?? 'Password reset failed'
+        } else {
+          error.value = 'Password reset failed'
+        }
+        throw err
+      } finally {
+        loading.value = false
+      }
+    }
+
+    return {
+      user,
+      loading,
+      error,
+      login,
+      register,
+      logout,
+      forgotPassword,
+      resetPassword
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,118 @@
+/**
+ * @socialkit/vue — Shared Vue 3 utilities for SocialKit-powered frontends.
+ *
+ * This package provides configurable building blocks (token storage, API service,
+ * auth service, auth store, terminology plugin) that each site frontend
+ * instantiates with its own configuration.
+ */
+
+// ── Types ────────────────────────────────────────────────────────────────────
+export type {
+  ApiResponse,
+  PaginatedResponse,
+  ApiError,
+  UploadProgressEvent,
+  RequestConfig
+} from './types/api.js'
+
+export type {
+  User,
+  IdentityUser
+} from './types/user.js'
+
+export {
+  isUser,
+  isIdentityUser,
+  identityUserToUser
+} from './types/user.js'
+
+// ── Token Storage ────────────────────────────────────────────────────────────
+export type {
+  TokenStorageConfig,
+  TokenStorage
+} from './utils/tokenStorage.js'
+
+export {
+  createTokenStorage,
+  extractTokenFromResponse
+} from './utils/tokenStorage.js'
+
+// ── API Service ──────────────────────────────────────────────────────────────
+export type {
+  ApiServiceConfig,
+  ApiService
+} from './services/api.js'
+
+export {
+  createApiService
+} from './services/api.js'
+
+// ── Auth Service ─────────────────────────────────────────────────────────────
+export type {
+  AuthServiceConfig,
+  AuthServiceInstance,
+  AuthenticatedLoginResponse,
+  AuthenticatedRegisterResponse,
+  AuthLoginResult,
+  ConfiguredTokenAuthClient,
+  ExtendedAuthServiceConfig,
+  ExtendedAuthServiceInstance,
+  RegisterData,
+  RegisterResponse,
+  ResetPasswordData,
+  LoginResponse,
+  TokenAuthClientConfig,
+  TwoFactorChallengeResponse,
+  VerificationRequiredRegisterResponse
+} from './services/auth.js'
+
+export {
+  configureTokenAuthClient,
+  createAuthService,
+  createExtendedAuthService
+} from './services/auth.js'
+
+// ── Auth Store ───────────────────────────────────────────────────────────────
+export type {
+  AuthStoreConfig,
+  AuthStoreActions,
+  AuthStoreExtension,
+  AuthStoreExtensionContext,
+  AuthStoreGetters,
+  AuthStoreStateRefs,
+  AuthStoreReturn
+} from './stores/auth.js'
+
+export {
+  createAuthStoreDefinition
+} from './stores/auth.js'
+
+// ── Auth Composable ──────────────────────────────────────────────────────────
+export type {
+  UseAuthReturn
+} from './composables/useAuth.js'
+
+export {
+  makeUseAuth
+} from './composables/useAuth.js'
+
+// ── Terminology Plugin ───────────────────────────────────────────────────────
+export type {
+  TermForms,
+  TermsBundle,
+  TerminologyOptions
+} from './plugins/terminology/types.js'
+
+export type {
+  TermOptions
+} from './plugins/terminology/terms.js'
+
+export {
+  makeTermHelpers
+} from './plugins/terminology/terms.js'
+
+export {
+  TerminologyPlugin,
+  useTerms,
+  getTermHelpers
+} from './plugins/terminology/index.js'