@codingfactory/socialkit-vue 0.1.0

package/dist/composables/useAuth.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 { type Ref, type ComputedRef } from 'vue';
+import type { AuthServiceInstance, RegisterData, ResetPasswordData } from '../services/auth.js';
+import type { User } from '../types/user.js';
+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 declare function makeUseAuth(authService: AuthServiceInstance, currentUser: Ref<User | null>): () => UseAuthReturn;
+//# sourceMappingURL=useAuth.d.ts.map

package/dist/composables/useAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAuth.d.ts","sourceRoot":"","sources":["../../src/composables/useAuth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAiB,KAAK,GAAG,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAA;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAC/F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AA0B5C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC,CAAA;IAC9B,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACrB,KAAK,EAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACzB,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7D,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACvB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/C,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACzD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,mBAAmB,EAChC,WAAW,EAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAC5B,MAAM,aAAa,CA4GrB"}

package/dist/composables/useAuth.js

@@ -0,0 +1,137 @@
+/**
+ * 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 } from 'vue';
+function isAxiosError(error) {
+    return error !== null && typeof error === 'object' && 'response' in error;
+}
+function extractForgotPasswordValidationMessage(error) {
+    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;
+}
+/**
+ * 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, currentUser) {
+    return function useAuth() {
+        const loading = ref(false);
+        const error = ref(null);
+        const user = computed(() => currentUser.value);
+        const login = async (credential, password) => {
+            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) => {
+            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 () => {
+            loading.value = true;
+            try {
+                await authService.logout();
+            }
+            finally {
+                loading.value = false;
+            }
+        };
+        const forgotPassword = async (email) => {
+            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) => {
+            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
+        };
+    };
+}
+//# sourceMappingURL=useAuth.js.map

package/dist/composables/useAuth.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @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.
+ */
+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';
+export type { TokenStorageConfig, TokenStorage } from './utils/tokenStorage.js';
+export { createTokenStorage, extractTokenFromResponse } from './utils/tokenStorage.js';
+export type { ApiServiceConfig, ApiService } from './services/api.js';
+export { createApiService } from './services/api.js';
+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';
+export type { AuthStoreConfig, AuthStoreActions, AuthStoreExtension, AuthStoreExtensionContext, AuthStoreGetters, AuthStoreStateRefs, AuthStoreReturn } from './stores/auth.js';
+export { createAuthStoreDefinition } from './stores/auth.js';
+export type { UseAuthReturn } from './composables/useAuth.js';
+export { makeUseAuth } from './composables/useAuth.js';
+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';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,QAAQ,EACR,mBAAmB,EACnB,aAAa,EACd,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,IAAI,EACJ,YAAY,EACb,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,MAAM,EACN,cAAc,EACd,kBAAkB,EACnB,MAAM,iBAAiB,CAAA;AAGxB,YAAY,EACV,kBAAkB,EAClB,YAAY,EACb,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,yBAAyB,CAAA;AAGhC,YAAY,EACV,gBAAgB,EAChB,UAAU,EACX,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,gBAAgB,EACjB,MAAM,mBAAmB,CAAA;AAG1B,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,EAC1B,6BAA6B,EAC7B,eAAe,EACf,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,0BAA0B,EAC1B,oCAAoC,EACrC,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,oBAAoB,CAAA;AAG3B,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EAChB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,yBAAyB,EAC1B,MAAM,kBAAkB,CAAA;AAGzB,YAAY,EACV,aAAa,EACd,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EACL,WAAW,EACZ,MAAM,0BAA0B,CAAA;AAGjC,YAAY,EACV,SAAS,EACT,WAAW,EACX,kBAAkB,EACnB,MAAM,gCAAgC,CAAA;AAEvC,YAAY,EACV,WAAW,EACZ,MAAM,gCAAgC,CAAA;AAEvC,OAAO,EACL,eAAe,EAChB,MAAM,gCAAgC,CAAA;AAEvC,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,cAAc,EACf,MAAM,gCAAgC,CAAA"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * @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.
+ */
+export { isUser, isIdentityUser, identityUserToUser } from './types/user.js';
+export { createTokenStorage, extractTokenFromResponse } from './utils/tokenStorage.js';
+export { createApiService } from './services/api.js';
+export { configureTokenAuthClient, createAuthService, createExtendedAuthService } from './services/auth.js';
+export { createAuthStoreDefinition } from './stores/auth.js';
+export { makeUseAuth } from './composables/useAuth.js';
+export { makeTermHelpers } from './plugins/terminology/terms.js';
+export { TerminologyPlugin, useTerms, getTermHelpers } from './plugins/terminology/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,OAAO,EACL,MAAM,EACN,cAAc,EACd,kBAAkB,EACnB,MAAM,iBAAiB,CAAA;AAQxB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,yBAAyB,CAAA;AAQhC,OAAO,EACL,gBAAgB,EACjB,MAAM,mBAAmB,CAAA;AAqB1B,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,oBAAoB,CAAA;AAa3B,OAAO,EACL,yBAAyB,EAC1B,MAAM,kBAAkB,CAAA;AAOzB,OAAO,EACL,WAAW,EACZ,MAAM,0BAA0B,CAAA;AAajC,OAAO,EACL,eAAe,EAChB,MAAM,gCAAgC,CAAA;AAEvC,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,cAAc,EACf,MAAM,gCAAgC,CAAA"}

package/dist/plugins/terminology/index.d.ts

@@ -0,0 +1,11 @@
+import type { Plugin } from 'vue';
+import { makeTermHelpers } from './terms.js';
+export declare const TerminologyPlugin: Plugin;
+/** Composition API helper to access terminology in setup(). */
+export declare function useTerms(): {
+    term: ReturnType<typeof makeTermHelpers>['term'];
+    segment: ReturnType<typeof makeTermHelpers>['segment'];
+};
+/** Get term helpers outside of a Vue component context (e.g. router). */
+export declare function getTermHelpers(): ReturnType<typeof makeTermHelpers>;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/terminology/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/terminology/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAO,MAAM,EAAE,MAAM,KAAK,CAAA;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAiD5C,eAAO,MAAM,iBAAiB,EAAE,MAsC/B,CAAA;AAED,+DAA+D;AAC/D,wBAAgB,QAAQ,IAAI;IAC1B,IAAI,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;IAChD,OAAO,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,SAAS,CAAC,CAAA;CACvD,CAUA;AAED,yEAAyE;AACzE,wBAAgB,cAAc,IAAI,UAAU,CAAC,OAAO,eAAe,CAAC,CAKnE"}

package/dist/plugins/terminology/index.js

@@ -0,0 +1,91 @@
+import { makeTermHelpers } from './terms.js';
+import { inject, ref } from 'vue';
+const termsBundle = {};
+let termHelpers = null;
+const termsVersion = ref(0);
+function ensureTermHelpers() {
+    if (termHelpers !== null) {
+        return termHelpers;
+    }
+    termHelpers = makeTermHelpers(termsBundle);
+    return termHelpers;
+}
+function applyTermsBundle(bundle) {
+    const existingKeys = Object.keys(termsBundle);
+    for (const key of existingKeys) {
+        delete termsBundle[key];
+    }
+    Object.assign(termsBundle, bundle);
+    termHelpers = makeTermHelpers(termsBundle);
+    termsVersion.value += 1;
+}
+function touchTermsVersion() {
+    void termsVersion.value;
+}
+function installTerminologyProviders(app) {
+    const termProxy = (key, opts) => {
+        touchTermsVersion();
+        return ensureTermHelpers().term(key, opts);
+    };
+    const segmentProxy = (key) => {
+        touchTermsVersion();
+        return ensureTermHelpers().segment(key);
+    };
+    app.config.globalProperties.$term = termProxy;
+    app.config.globalProperties.$segment = segmentProxy;
+    app.provide('terms:term', termProxy);
+    app.provide('terms:segment', segmentProxy);
+    app.provide('terms:bundle', termsBundle);
+}
+export const TerminologyPlugin = {
+    async install(app, opts) {
+        const brand = opts?.brand ?? 'default';
+        const locale = opts?.locale ?? 'en';
+        let url = opts?.bundleUrl ?? `/brands/${brand}.${locale}.json`;
+        installTerminologyProviders(app);
+        const runtimeOrigin = typeof window !== 'undefined' ? window.location.origin : '';
+        const apiBase = (opts?.apiBaseUrl ?? runtimeOrigin).replace(/\/$/, '');
+        const canUseApiFallback = apiBase.length > 0 && url.startsWith('/');
+        try {
+            let response = await fetch(url, { cache: 'no-cache' });
+            if (canUseApiFallback && (!response.ok || response.headers.get('content-type')?.includes('text/html'))) {
+                // Fall back to the backend origin when the frontend dev server does not serve the brand bundle.
+                url = `${apiBase}${url}`;
+                response = await fetch(url, {
+                    credentials: 'include',
+                    headers: { Accept: 'application/json' }
+                });
+            }
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: Failed to load terminology bundle from ${url}`);
+            }
+            const contentType = response.headers.get('content-type');
+            if (!contentType?.includes('application/json')) {
+                throw new Error(`Invalid content-type: ${contentType ?? 'unknown'}. Expected JSON from ${url}`);
+            }
+            const data = await response.json();
+            applyTermsBundle(data.terms ?? data);
+        }
+        catch {
+            applyTermsBundle({});
+        }
+    }
+};
+/** Composition API helper to access terminology in setup(). */
+export function useTerms() {
+    const term = inject('terms:term');
+    const segment = inject('terms:segment');
+    if (!term || !segment) {
+        const fallback = makeTermHelpers({});
+        return { term: fallback.term, segment: fallback.segment };
+    }
+    return { term, segment };
+}
+/** Get term helpers outside of a Vue component context (e.g. router). */
+export function getTermHelpers() {
+    if (!termHelpers) {
+        return makeTermHelpers({});
+    }
+    return termHelpers;
+}
+//# sourceMappingURL=index.js.map

package/dist/plugins/terminology/index.js.map

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

package/dist/plugins/terminology/terms.d.ts

@@ -0,0 +1,15 @@
+import type { TermsBundle } from './types.js';
+type TermCase = 'title' | 'upper' | 'lower';
+type TermForm = 'noun' | 'relation_noun' | 'verb' | 'verb_past' | 'verb_ing';
+export interface TermOptions {
+    form?: TermForm;
+    count?: number;
+    ui?: string;
+    case?: TermCase;
+}
+export declare function makeTermHelpers(bundle: TermsBundle): {
+    term: (key: string, opts?: TermOptions) => string;
+    segment: (key: string) => string;
+};
+export {};
+//# sourceMappingURL=terms.d.ts.map

package/dist/plugins/terminology/terms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terms.d.ts","sourceRoot":"","sources":["../../../src/plugins/terminology/terms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,YAAY,CAAA;AAExD,KAAK,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;AAC3C,KAAK,QAAQ,GAAG,MAAM,GAAG,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAA;AAG5E,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,QAAQ,CAAA;CAChB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG;IACpD,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,MAAM,CAAA;IACjD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;CACjC,CAuFA"}

package/dist/plugins/terminology/terms.js

@@ -0,0 +1,72 @@
+export function makeTermHelpers(bundle) {
+    const emptyNode = {};
+    const fallbackLabel = (key) => {
+        const lastSegment = key.split('.').pop();
+        return (lastSegment ?? key).replace(/[_-]/g, ' ');
+    };
+    const getNode = (key) => bundle[key] ?? emptyNode;
+    const plural = (one, other, count) => {
+        const fallback = one ?? other;
+        if (fallback === undefined) {
+            return undefined;
+        }
+        if (count == null) {
+            return fallback;
+        }
+        return count === 1 ? (one ?? fallback) : (other ?? fallback);
+    };
+    const applyCase = (value, casing) => {
+        if (!value) {
+            return value;
+        }
+        switch (casing) {
+            case 'upper':
+                return value.toUpperCase();
+            case 'lower':
+                return value.toLowerCase();
+            case 'title':
+                return value.replace(/\b\w/g, (match) => match.toUpperCase());
+            default:
+                return value;
+        }
+    };
+    const getFormValue = (node, form) => {
+        switch (form) {
+            case 'verb':
+                return node.verb;
+            case 'verb_past':
+                return node.verb_past;
+            case 'verb_ing':
+                return node.verb_ing;
+            default:
+                return undefined;
+        }
+    };
+    const term = (key, opts = {}) => {
+        const node = getNode(key);
+        if (opts.ui) {
+            return applyCase(node.ui?.[opts.ui] ?? fallbackLabel(key), opts.case);
+        }
+        const form = opts.form ?? 'noun';
+        if (form === 'noun') {
+            const out = plural(node.noun?.one, node.noun?.other, opts.count) ?? fallbackLabel(key);
+            return applyCase(out, opts.case);
+        }
+        if (form === 'relation_noun') {
+            const out = plural(node.relation_noun?.one, node.relation_noun?.other, opts.count) ?? fallbackLabel(key);
+            return applyCase(out, opts.case);
+        }
+        const raw = getFormValue(node, form) ?? fallbackLabel(key);
+        return applyCase(raw, opts.case);
+    };
+    const segment = (key) => {
+        const node = getNode(key);
+        if (node.url_segment) {
+            return node.url_segment;
+        }
+        const base = node.noun?.other ?? node.noun?.one ?? fallbackLabel(key);
+        return base.toLowerCase().replace(/\s+/g, '-');
+    };
+    return { term, segment };
+}
+//# sourceMappingURL=terms.js.map

package/dist/plugins/terminology/terms.js.map

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

package/dist/plugins/terminology/types.d.ts

@@ -0,0 +1,32 @@
+export interface TermForms {
+    noun?: {
+        one?: string;
+        other?: string;
+    };
+    relation_noun?: {
+        one?: string;
+        other?: string;
+    };
+    verb?: string;
+    verb_past?: string;
+    verb_ing?: string;
+    url_segment?: string;
+    ui?: Record<string, string>;
+}
+export type TermsBundle = Record<string, TermForms>;
+export interface TerminologyOptions {
+    brand: string;
+    locale: string;
+    /** Override the bundle URL (default: `/brands/${brand}.${locale}.json`). */
+    bundleUrl?: string;
+    /** API base URL for fallback fetching in development. */
+    apiBaseUrl?: string;
+    onVersionMismatch?: (serverVersion: string) => void;
+}
+declare module 'vue' {
+    interface ComponentCustomProperties {
+        $term: (key: string, opts?: Record<string, unknown>) => string;
+        $segment: (key: string) => string;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/terminology/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/terminology/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACvC,aAAa,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC5B;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AAEnD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAA;CACpD;AAED,OAAO,QAAQ,KAAK,CAAC;IACnB,UAAU,yBAAyB;QACjC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;QAC9D,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;KAClC;CACF"}

package/dist/plugins/terminology/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/terminology/types.js.map

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

package/dist/services/api.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Configurable API service for SocialKit-powered frontends.
+ */
+import type { AxiosInstance, AxiosResponse } from 'axios';
+import type { ApiResponse, RequestConfig } from '../types/api.js';
+import type { TokenStorage } from '../utils/tokenStorage.js';
+/** Configuration for creating an API service instance. */
+export interface ApiServiceConfig {
+    /** Base URL for API requests (e.g. '/api' or 'https://api.example.com/api'). */
+    baseURL: string;
+    /** Token storage instance for auth headers and refresh logic. */
+    tokenStorage: TokenStorage;
+    /** Optional existing Axios client to configure instead of creating a new one. */
+    client?: AxiosInstance;
+    /** Request timeout in milliseconds (default: 30000). */
+    timeout?: number;
+    /** Paths that are considered auth pages and won't be redirected to (default: ['/login', '/register']). */
+    authPagePaths?: string[];
+    /** Path to redirect to when auth fails (default: '/login'). */
+    loginPath?: string;
+    /** Delay in ms before redirecting on auth failure (default: 1500). */
+    authFailureRedirectDelayMs?: number;
+    /** Optional error handler called on every response error. */
+    onResponseError?: (error: unknown) => void;
+    /** Optional callback invoked just before local auth state is cleared. */
+    onAuthInvalidated?: () => void;
+    /** Override the redirect target used when auth teardown occurs. */
+    buildLoginRedirectUrl?: () => string;
+    /** Max retries for transient 502/503/504 idempotent requests (default: 2). */
+    maxServerRetries?: number;
+    /** Base delay in ms for transient server retries (default: 500). */
+    serverRetryBaseDelayMs?: number;
+}
+/** Public API service interface. */
+export interface ApiService {
+    get<T = unknown>(url: string, config?: RequestConfig): Promise<ApiResponse<T>>;
+    post<T = unknown>(url: string, data?: unknown, config?: RequestConfig): Promise<ApiResponse<T>>;
+    put<T = unknown>(url: string, data?: unknown, config?: RequestConfig): Promise<ApiResponse<T>>;
+    patch<T = unknown>(url: string, data?: unknown, config?: RequestConfig): Promise<ApiResponse<T>>;
+    delete<T = unknown>(url: string, config?: RequestConfig): Promise<ApiResponse<T>>;
+    postForm<T = unknown>(url: string, form: FormData, config?: RequestConfig): Promise<T>;
+    postFormRaw<T = unknown>(url: string, form: FormData, config?: RequestConfig): Promise<AxiosResponse<T>>;
+    markAuthRecoveryHandled(): void;
+    hasPendingAuthRequest(): boolean;
+    clearPendingAuthRequest(): void;
+    replayPendingAuthRequest(token: string): Promise<void>;
+}
+/** Create a configured API service instance. */
+export declare function createApiService(config: ApiServiceConfig): ApiService;
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/services/api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAsB,aAAa,EAAE,MAAM,OAAO,CAAA;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAA;IACf,iEAAiE;IACjE,YAAY,EAAE,YAAY,CAAA;IAC1B,iFAAiF;IACjF,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0GAA0G;IAC1G,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,0BAA0B,CAAC,EAAE,MAAM,CAAA;IACnC,6DAA6D;IAC7D,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAC1C,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B,mEAAmE;IACnE,qBAAqB,CAAC,EAAE,MAAM,MAAM,CAAA;IACpC,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,oEAAoE;IACpE,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC;AAwID,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9E,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/F,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9F,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IAChG,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IACjF,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACtF,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAA;IACxG,uBAAuB,IAAI,IAAI,CAAA;IAC/B,qBAAqB,IAAI,OAAO,CAAA;IAChC,uBAAuB,IAAI,IAAI,CAAA;IAC/B,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACvD;AAED,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CA4RrE"}