@timeback/sdk 0.1.7 → 0.1.9

package/dist/client/adapters/svelte/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Svelte Types
+ *
+ * Types for Svelte-specific stores.
+ */
+import type { TimebackProfile } from '../../../shared/types';
+/**
+ * Verification state for the current user.
+ */
+export type TimebackVerificationState = {
+    status: 'loading';
+} | {
+    status: 'verified';
+    timebackId: string;
+} | {
+    status: 'unverified';
+} | {
+    status: 'error';
+    message: string;
+};
+/**
+ * Profile state for the current user.
+ */
+export type TimebackProfileState = {
+    status: 'idle';
+} | {
+    status: 'loading';
+} | {
+    status: 'loaded';
+    profile: TimebackProfile;
+} | {
+    status: 'error';
+    message: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/client/adapters/svelte/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/svelte/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAClC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GACxB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvC;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC7B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GAC9C;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA"}

package/dist/client/adapters/vue/composables/useTimebackProfile.d.ts

@@ -0,0 +1,51 @@
+/**
+ * useTimebackProfile
+ *
+ * Vue composable for fetching the current user's Timeback profile.
+ *
+ * This composable uses `useTimebackVerification` internally and only fetches
+ * the profile when the user is verified (i.e., exists in Timeback).
+ */
+import type { ComputedRef, Ref } from 'vue';
+import type { TimebackProfileState, UseTimebackProfileOptions } from '../types';
+/**
+ * Fetch the current user's Timeback profile.
+ *
+ * This composable internally uses `useTimebackVerification` to ensure the user
+ * is verified before fetching. When `auto: true`, it automatically fetches
+ * the profile once verified. Otherwise, call `fetchProfile()` manually.
+ *
+ * @param options - Composable options
+ * @param options.enabled - If false, the composable does nothing and stays in idle state. Defaults to true.
+ * @param options.auto - If true, automatically fetch once verified. Defaults to false.
+ * @returns Profile state and fetch methods
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useTimebackProfile } from '@timeback/sdk/vue'
+ *
+ * // Manual fetch
+ * const { state, canFetch, fetchProfile } = useTimebackProfile()
+ *
+ * // Or auto-fetch
+ * // const { state } = useTimebackProfile({ auto: true })
+ * </script>
+ *
+ * <template>
+ *   <div v-if="state.status === 'loaded'">
+ *     XP: {{ state.profile.xp }}
+ *   </div>
+ *   <button v-else @click="fetchProfile" :disabled="!canFetch">
+ *     {{ state.status === 'loading' ? 'Loading...' : 'Load Profile' }}
+ *   </button>
+ * </template>
+ * ```
+ */
+export declare function useTimebackProfile(options?: UseTimebackProfileOptions): {
+    state: Ref<TimebackProfileState>;
+    canFetch: ComputedRef<boolean>;
+    fetchProfile: () => void;
+    refresh: () => void;
+};
+//# sourceMappingURL=useTimebackProfile.d.ts.map

package/dist/client/adapters/vue/composables/useTimebackProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTimebackProfile.d.ts","sourceRoot":"","sources":["../../../../../src/client/adapters/vue/composables/useTimebackProfile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAC3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAA;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG;IAC5E,KAAK,EAAE,GAAG,CAAC,oBAAoB,CAAC,CAAA;IAChC,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAC9B,YAAY,EAAE,MAAM,IAAI,CAAA;IACxB,OAAO,EAAE,MAAM,IAAI,CAAA;CACnB,CAgIA"}

package/dist/client/adapters/vue/composables/useTimebackProfile.ts

@@ -0,0 +1,186 @@
+/**
+ * useTimebackProfile
+ *
+ * Vue composable for fetching the current user's Timeback profile.
+ *
+ * This composable uses `useTimebackVerification` internally and only fetches
+ * the profile when the user is verified (i.e., exists in Timeback).
+ */
+
+import { computed, ref, watch } from 'vue'
+
+import { fetchProfileOnce, getProfileCache } from '../../../lib/user-cache'
+import { useTimeback } from '../provider'
+import { useTimebackVerification } from './useTimebackVerification'
+
+import type { ComputedRef, Ref } from 'vue'
+import type { TimebackProfileState, UseTimebackProfileOptions } from '../types'
+
+/**
+ * Fetch the current user's Timeback profile.
+ *
+ * This composable internally uses `useTimebackVerification` to ensure the user
+ * is verified before fetching. When `auto: true`, it automatically fetches
+ * the profile once verified. Otherwise, call `fetchProfile()` manually.
+ *
+ * @param options - Composable options
+ * @param options.enabled - If false, the composable does nothing and stays in idle state. Defaults to true.
+ * @param options.auto - If true, automatically fetch once verified. Defaults to false.
+ * @returns Profile state and fetch methods
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useTimebackProfile } from '@timeback/sdk/vue'
+ *
+ * // Manual fetch
+ * const { state, canFetch, fetchProfile } = useTimebackProfile()
+ *
+ * // Or auto-fetch
+ * // const { state } = useTimebackProfile({ auto: true })
+ * </script>
+ *
+ * <template>
+ *   <div v-if="state.status === 'loaded'">
+ *     XP: {{ state.profile.xp }}
+ *   </div>
+ *   <button v-else @click="fetchProfile" :disabled="!canFetch">
+ *     {{ state.status === 'loading' ? 'Loading...' : 'Load Profile' }}
+ *   </button>
+ * </template>
+ * ```
+ */
+export function useTimebackProfile(options: UseTimebackProfileOptions = {}): {
+	state: Ref<TimebackProfileState>
+	canFetch: ComputedRef<boolean>
+	fetchProfile: () => void
+	refresh: () => void
+} {
+	const { enabled = true, auto = false } = options
+
+	const timebackRef = useTimeback()
+	const { state: verificationState } = useTimebackVerification({ enabled })
+
+	const state = ref<TimebackProfileState>({ status: 'idle' }) as Ref<TimebackProfileState>
+	const fetchNonce = ref(0)
+	const refreshNonce = ref(0)
+
+	let lastHandledFetchNonce = 0
+	let lastHandledRefreshNonce = 0
+	let autoTriggered = false
+
+	const canFetch = computed(
+		() => enabled && verificationState.value.status === 'verified' && !!timebackRef.value,
+	)
+
+	const fetchProfile = () => {
+		if (!canFetch.value) {
+			return
+		}
+
+		fetchNonce.value++
+	}
+
+	const refresh = () => {
+		if (!canFetch.value) {
+			return
+		}
+
+		refreshNonce.value++
+	}
+
+	watch(
+		[verificationState, fetchNonce, refreshNonce, () => timebackRef.value],
+		async ([verification, fetchN, refreshN, timeback], _prev, onCleanup) => {
+			if (!enabled) {
+				state.value = { status: 'idle' }
+
+				return
+			}
+
+			let cancelled = false
+
+			onCleanup(() => {
+				cancelled = true
+			})
+
+			if (verification.status !== 'verified') {
+				if (state.value.status !== 'idle') {
+					state.value = { status: 'idle' }
+				}
+
+				autoTriggered = false
+
+				return
+			}
+
+			if (auto && !autoTriggered && fetchN === 0 && refreshN === 0) {
+				autoTriggered = true
+				fetchNonce.value = 1
+				return
+			}
+
+			if (fetchN === 0 && refreshN === 0) {
+				return
+			}
+
+			const isNewFetch = fetchN > lastHandledFetchNonce
+			const isNewRefresh = refreshN > lastHandledRefreshNonce
+			const force = isNewRefresh
+
+			if (!isNewFetch && !isNewRefresh) {
+				if (timeback) {
+					const cached = getProfileCache(timeback)
+
+					if (cached) {
+						state.value = { status: 'loaded', profile: cached }
+
+						return
+					}
+				}
+
+				return
+			}
+
+			if (timeback && !force) {
+				const cached = getProfileCache(timeback)
+
+				if (cached) {
+					state.value = { status: 'loaded', profile: cached }
+					lastHandledFetchNonce = fetchN
+
+					return
+				}
+			}
+
+			state.value = { status: 'loading' }
+
+			try {
+				if (!timeback) {
+					return
+				}
+
+				lastHandledFetchNonce = fetchN
+				lastHandledRefreshNonce = refreshN
+
+				const profile = await fetchProfileOnce(timeback, force)
+
+				if (cancelled) {
+					return
+				}
+
+				state.value = { status: 'loaded', profile }
+			} catch (err) {
+				if (!cancelled) {
+					state.value = {
+						status: 'error',
+						message: err instanceof Error ? err.message : 'Failed to fetch profile',
+					}
+				}
+			}
+		},
+		{ immediate: true },
+	)
+
+	return { state, canFetch, fetchProfile, refresh }
+}

package/dist/client/adapters/vue/composables/useTimebackVerification.d.ts

@@ -0,0 +1,46 @@
+/**
+ * useTimebackVerification
+ *
+ * Vue composable for checking whether the current user can be verified in Timeback.
+ *
+ * This is a lightweight check (backed by `/api/timeback/user/verify`) and is
+ * intended for partner gating flows (e.g., "free for Timeback users").
+ */
+import type { Ref } from 'vue';
+import type { TimebackVerificationState, UseTimebackVerificationOptions } from '../types';
+/**
+ * Verify the current user against Timeback.
+ *
+ * The composable runs automatically once the Timeback client is available, and
+ * provides a `refresh()` method to retry.
+ *
+ * By default, the composable retries failed verification attempts with exponential
+ * backoff to handle race conditions (e.g., user not yet created in backend).
+ *
+ * @param options - Composable options
+ * @returns Verification state and a refresh method
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useTimebackVerification } from '@timeback/sdk/vue'
+ *
+ * const { state, refresh } = useTimebackVerification()
+ * </script>
+ *
+ * <template>
+ *   <div v-if="state.status === 'verified'">
+ *     Verified as {{ state.timebackId }}
+ *   </div>
+ *   <div v-else-if="state.status === 'loading'">
+ *     Verifying...
+ *   </div>
+ *   <button @click="refresh">Refresh</button>
+ * </template>
+ * ```
+ */
+export declare function useTimebackVerification(options?: UseTimebackVerificationOptions): {
+    state: Ref<TimebackVerificationState>;
+    refresh: () => void;
+};
+//# sourceMappingURL=useTimebackVerification.d.ts.map

package/dist/client/adapters/vue/composables/useTimebackVerification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTimebackVerification.d.ts","sourceRoot":"","sources":["../../../../../src/client/adapters/vue/composables/useTimebackVerification.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAE9B,OAAO,KAAK,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,UAAU,CAAA;AAczF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,8BAAmC,GAAG;IACtF,KAAK,EAAE,GAAG,CAAC,yBAAyB,CAAC,CAAA;IACrC,OAAO,EAAE,MAAM,IAAI,CAAA;CACnB,CAsGA"}

package/dist/client/adapters/vue/composables/useTimebackVerification.ts

@@ -0,0 +1,169 @@
+/**
+ * useTimebackVerification
+ *
+ * Vue composable for checking whether the current user can be verified in Timeback.
+ *
+ * This is a lightweight check (backed by `/api/timeback/user/verify`) and is
+ * intended for partner gating flows (e.g., "free for Timeback users").
+ */
+
+import { ref, watch } from 'vue'
+
+import { DEFAULT_RETRY_ATTEMPTS, DEFAULT_RETRY_DELAYS_MS } from '../../../../shared/constants'
+import { getVerifyCache, verifyOnce } from '../../../lib/user-cache'
+import { getRetryDelay, sleep } from '../../../lib/utils'
+import { useTimeback } from '../provider'
+
+import type { Ref } from 'vue'
+import type { TimebackVerifyResult } from '../../../../shared/types'
+import type { TimebackVerificationState, UseTimebackVerificationOptions } from '../types'
+
+/**
+ * Convert a verify result into a composable-friendly state machine.
+ *
+ * @param result - Raw verify result from the SDK client
+ * @returns Mapped verification state
+ */
+function toState(result: TimebackVerifyResult): TimebackVerificationState {
+	return result.verified
+		? { status: 'verified', timebackId: result.timebackId }
+		: { status: 'unverified' }
+}
+
+/**
+ * Verify the current user against Timeback.
+ *
+ * The composable runs automatically once the Timeback client is available, and
+ * provides a `refresh()` method to retry.
+ *
+ * By default, the composable retries failed verification attempts with exponential
+ * backoff to handle race conditions (e.g., user not yet created in backend).
+ *
+ * @param options - Composable options
+ * @returns Verification state and a refresh method
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useTimebackVerification } from '@timeback/sdk/vue'
+ *
+ * const { state, refresh } = useTimebackVerification()
+ * </script>
+ *
+ * <template>
+ *   <div v-if="state.status === 'verified'">
+ *     Verified as {{ state.timebackId }}
+ *   </div>
+ *   <div v-else-if="state.status === 'loading'">
+ *     Verifying...
+ *   </div>
+ *   <button @click="refresh">Refresh</button>
+ * </template>
+ * ```
+ */
+export function useTimebackVerification(options: UseTimebackVerificationOptions = {}): {
+	state: Ref<TimebackVerificationState>
+	refresh: () => void
+} {
+	const enabled = options.enabled ?? true
+	const retryAttempts = options.retryAttempts ?? DEFAULT_RETRY_ATTEMPTS
+	const retryDelays = options.retryDelays ?? DEFAULT_RETRY_DELAYS_MS
+	const timebackRef = useTimeback()
+
+	const state = ref<TimebackVerificationState>({
+		status: 'loading',
+	}) as Ref<TimebackVerificationState>
+	const refreshNonce = ref(0)
+
+	let lastHandledRefreshNonce = 0
+
+	const refresh = () => {
+		if (!enabled) return
+		refreshNonce.value++
+	}
+
+	watch(
+		[() => timebackRef.value, refreshNonce],
+		async ([timeback, nonce], _prev, onCleanup) => {
+			if (!enabled) return
+
+			let cancelled = false
+
+			onCleanup(() => {
+				cancelled = true
+			})
+
+			const force = nonce > lastHandledRefreshNonce
+
+			if (timeback && !force) {
+				const cached = getVerifyCache(timeback)
+
+				if (cached) {
+					state.value = toState(cached)
+					return
+				}
+			}
+
+			state.value = { status: 'loading' }
+
+			if (!timeback) return
+
+			if (force) {
+				lastHandledRefreshNonce = nonce
+			}
+
+			let lastError: Error | undefined
+
+			for (let attempt = 0; attempt <= retryAttempts; attempt++) {
+				if (cancelled) return
+
+				/**
+				 * Wait for a calculated delay before retrying the verification request.
+				 *
+				 * This occurs only on subsequent attempts (not the initial try),
+				 * introducing a backoff based on the configured retry delays.
+				 */
+				if (attempt > 0) {
+					const delay = getRetryDelay(retryDelays, attempt - 1)
+					await sleep(delay)
+					if (cancelled) return
+				}
+
+				try {
+					const result = await verifyOnce(timeback, force || attempt > 0)
+
+					if (cancelled) return
+
+					state.value = toState(result)
+
+					return
+				} catch (err) {
+					lastError =
+						err instanceof Error ? err : new Error('Failed to verify Timeback user')
+					/**
+					 * An error occurred during this verification attempt.
+					 * Proceeding to the next retry attempt if any remain.
+					 *
+					 * The last encountered error is saved for potential error state handling.
+					 */
+				}
+			}
+
+			/**
+			 * All verification attempts have failed after exhausting
+			 * the configured retry policy. The verification state will
+			 * transition to "error" if not cancelled, and the last encountered
+			 * error message (if available) will be presented to the consumer.
+			 */
+			if (!cancelled && lastError) {
+				state.value = {
+					status: 'error',
+					message: lastError.message,
+				}
+			}
+		},
+		{ immediate: true },
+	)
+
+	return { state, refresh }
+}

package/dist/client/adapters/vue/index.d.ts

@@ -37,6 +37,9 @@
 export { Activity, createClient, TimebackClient } from '@timeback/sdk/client';
 export type { ActivityMetrics, ActivityParams, TimebackIdentity } from '@timeback/sdk/client';
 export { TimebackProvider, useTimeback } from './provider';
+export { useTimebackVerification } from './composables/useTimebackVerification';
+export { useTimebackProfile } from './composables/useTimebackProfile';
+export type { TimebackProfileState, TimebackVerificationState, UseTimebackProfileOptions, UseTimebackProfileResult, UseTimebackVerificationOptions, UseTimebackVerificationResult, } from './types';
 export { default as SignInButton } from './SignInButton.vue';
 export type { SignInButtonProps } from './SignInButton.vue';
 //# sourceMappingURL=index.d.ts.map

package/dist/client/adapters/vue/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/vue/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAGH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC7E,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAG7F,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG1D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAC5D,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/vue/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC7E,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAG7F,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAA;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AACrE,YAAY,EACX,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,EAC9B,6BAA6B,GAC7B,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAC5D,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/client/adapters/vue/index.ts

@@ -35,13 +35,24 @@
  * ```
  */
 
-// Re-export from timeback/client for convenience
 export { Activity, createClient, TimebackClient } from '@timeback/sdk/client'
 export type { ActivityMetrics, ActivityParams, TimebackIdentity } from '@timeback/sdk/client'
 
 // Vue-specific
 export { TimebackProvider, useTimeback } from './provider'
 
+// Composables
+export { useTimebackVerification } from './composables/useTimebackVerification'
+export { useTimebackProfile } from './composables/useTimebackProfile'
+export type {
+	TimebackProfileState,
+	TimebackVerificationState,
+	UseTimebackProfileOptions,
+	UseTimebackProfileResult,
+	UseTimebackVerificationOptions,
+	UseTimebackVerificationResult,
+} from './types'
+
 // Components
 export { default as SignInButton } from './SignInButton.vue'
 export type { SignInButtonProps } from './SignInButton.vue'

package/dist/client/adapters/vue/types.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Vue Types
+ *
+ * Types for Vue-specific composables.
+ */
+import type { TimebackProfile } from '../../../shared/types';
+/**
+ * Verification state for the current user.
+ */
+export type TimebackVerificationState = {
+    status: 'loading';
+} | {
+    status: 'verified';
+    timebackId: string;
+} | {
+    status: 'unverified';
+} | {
+    status: 'error';
+    message: string;
+};
+/**
+ * Profile state for the current user.
+ */
+export type TimebackProfileState = {
+    status: 'idle';
+} | {
+    status: 'loading';
+} | {
+    status: 'loaded';
+    profile: TimebackProfile;
+} | {
+    status: 'error';
+    message: string;
+};
+/**
+ * Options for the useTimebackVerification composable.
+ */
+export interface UseTimebackVerificationOptions {
+    /**
+     * If false, the composable does nothing and stays in loading state.
+     *
+     * Use this to delay verification until prerequisites are met
+     * (e.g., user exists in your database).
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Number of retry attempts on failure.
+     *
+     * This helps handle race conditions where the user may not be
+     * fully set up in the backend when verification first runs.
+     *
+     * Set to 0 to disable retries.
+     *
+     * @default 3
+     */
+    retryAttempts?: number;
+    /**
+     * Delay in ms before each retry attempt.
+     *
+     * Can be a single number (same delay for all retries) or an array
+     * of delays for each attempt (e.g., [100, 300, 1000] for exponential backoff).
+     *
+     * @default [100, 300, 1000]
+     */
+    retryDelays?: number | readonly number[];
+}
+/**
+ * Return value of the useTimebackVerification composable.
+ */
+export interface UseTimebackVerificationResult {
+    /** Current verification state (reactive ref) */
+    state: TimebackVerificationState;
+    /** Force a re-verification. No-op if not enabled. */
+    refresh: () => void;
+}
+/**
+ * Options for the useTimebackProfile composable.
+ */
+export interface UseTimebackProfileOptions {
+    /**
+     * If false, the composable does nothing and stays in idle state.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * If true, automatically fetch the profile once the user is verified.
+     * If false, you must call `fetchProfile()` manually.
+     *
+     * @default false
+     */
+    auto?: boolean;
+}
+/**
+ * Return value of the useTimebackProfile composable.
+ */
+export interface UseTimebackProfileResult {
+    /** Current profile state (reactive ref) */
+    state: TimebackProfileState;
+    /** Whether the profile can be fetched (user is verified and client is ready) */
+    canFetch: boolean;
+    /** Manually trigger a profile fetch. No-op if canFetch is false. */
+    fetchProfile: () => void;
+    /** Force a re-fetch even if already loaded. No-op if canFetch is false. */
+    refresh: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/adapters/vue/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/vue/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAClC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GACxB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvC;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC7B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GAC9C;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvC;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC9C;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC7C,gDAAgD;IAChD,KAAK,EAAE,yBAAyB,CAAA;IAEhC,qDAAqD;IACrD,OAAO,EAAE,MAAM,IAAI,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACzC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACxC,2CAA2C;IAC3C,KAAK,EAAE,oBAAoB,CAAA;IAE3B,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAA;IAEjB,oEAAoE;IACpE,YAAY,EAAE,MAAM,IAAI,CAAA;IAExB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,IAAI,CAAA;CACnB"}