@timeback/sdk 0.1.7 → 0.1.8

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,44 @@
+/**
+ * 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.
+ *
+ * @param options - Composable options
+ * @param options.enabled - If false, the composable does nothing and stays in loading state.
+ * @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;AAOH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAE9B,OAAO,KAAK,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,UAAU,CAAA;AAczF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,uBAAuB,CACtC,OAAO,GAAE,8BAAmC,GAC1C;IACF,KAAK,EAAE,GAAG,CAAC,yBAAyB,CAAC,CAAA;IACrC,OAAO,EAAE,MAAM,IAAI,CAAA;CACnB,CA+DA"}

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

@@ -0,0 +1,128 @@
+/**
+ * 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 { getVerifyCache, verifyOnce } from '../../../lib/user-cache'
+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.
+ *
+ * @param options - Composable options
+ * @param options.enabled - If false, the composable does nothing and stays in loading state.
+ * @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 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' }
+
+			try {
+				if (!timeback) return
+
+				if (force) {
+					lastHandledRefreshNonce = nonce
+				}
+
+				const result = await verifyOnce(timeback, force)
+
+				if (cancelled) return
+
+				state.value = toState(result)
+			} catch (err) {
+				if (!cancelled) {
+					state.value = {
+						status: 'error',
+						message: err instanceof Error ? err.message : 'Failed to verify Timeback user',
+					}
+				}
+			}
+		},
+		{ 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,86 @@
+/**
+ * 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.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+}
+/**
+ * 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;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;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"}

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

@@ -0,0 +1,85 @@
+/**
+ * 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.
+	 *
+	 * @default true
+	 */
+	enabled?: boolean
+}
+
+/**
+ * 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
+}

package/dist/client/lib/activity/activity.class.d.ts

@@ -3,7 +3,7 @@
  *
  * Client-side activity tracking logic.
  */
-import type { ActivityEndPayload, ActivityMetrics, ActivityParams } from '../../../shared/types';
+import type { ActivityEndData, ActivityEndPayload, ActivityParams } from '../../../shared/types';
 /**
  * Activity tracker that tracks time spent on an activity.
  *
@@ -51,10 +51,10 @@ export declare class Activity {
      * Useful for "preview" flows in examples where you want to inspect the payload
      * that would be POSTed to the server without calling `end()`.
      *
-     * @param data - Activity completion data (metrics + optional metadata)
+     * @param data - Activity completion data (metrics + optional time override)
      * @returns Activity end payload
      */
-    _buildPayload(data: ActivityMetrics & Pick<Partial<ActivityEndPayload>, 'attemptNumber' | 'pctCompleteApp'>): ActivityEndPayload;
+    _buildPayload(data: ActivityEndData): ActivityEndPayload;
     /**
      * Pause the activity timer.
      */
@@ -66,8 +66,8 @@ export declare class Activity {
     /**
      * End the activity and send to server.
      *
-     * @param data - Activity completion data (metrics + optional metadata)
+     * @param data - Activity completion data (metrics + optional time override)
      */
-    end(data: ActivityMetrics & Pick<Partial<ActivityEndPayload>, 'attemptNumber' | 'pctCompleteApp'>): Promise<void>;
+    end(data: ActivityEndData): Promise<void>;
 }
 //# sourceMappingURL=activity.class.d.ts.map

package/dist/client/lib/activity/activity.class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity.class.d.ts","sourceRoot":"","sources":["../../../../src/client/lib/activity/activity.class.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEhG;;;;;GAKG;AACH,qBAAa,QAAQ;IAgBnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAhB9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAM;IACjC,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,MAAM,CAAQ;IAEtB;;;;;;;OAOG;IACH,YACkB,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,EAG7E;IAED;;;;OAIG;IACH,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED;;;;OAIG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;OAIG;IACH,IAAI,SAAS,IAAI,MAAM,CAatB;IAED;;;;;;;;OAQG;IACH,aAAa,CACZ,IAAI,EAAE,eAAe,GACpB,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,eAAe,GAAG,gBAAgB,CAAC,GACpE,kBAAkB,CAyBpB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAIZ;IAED;;OAEG;IACH,MAAM,IAAI,IAAI,CAKb;IAED;;;;OAIG;IACG,GAAG,CACR,IAAI,EAAE,eAAe,GACpB,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,eAAe,GAAG,gBAAgB,CAAC,GACpE,OAAO,CAAC,IAAI,CAAC,CAaf;CACD"}
+{"version":3,"file":"activity.class.d.ts","sourceRoot":"","sources":["../../../../src/client/lib/activity/activity.class.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEhG;;;;;GAKG;AACH,qBAAa,QAAQ;IAgBnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAhB9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAM;IACjC,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,MAAM,CAAQ;IAEtB;;;;;;;OAOG;IACH,YACkB,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,EAG7E;IAED;;;;OAIG;IACH,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED;;;;OAIG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;OAIG;IACH,IAAI,SAAS,IAAI,MAAM,CAatB;IAED;;;;;;;;OAQG;IACH,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,kBAAkB,CAiDvD;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAIZ;IAED;;OAEG;IACH,MAAM,IAAI,IAAI,CAKb;IAED;;;;OAIG;IACG,GAAG,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAa9C;CACD"}

package/dist/client/lib/user-cache.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Shared User Cache
+ *
+ * Internal module for in-flight deduplication and short-lived caching of
+ * verify and profile requests. Used by Solid, Svelte, and Vue adapters.
+ */
+import type { TimebackProfile, TimebackVerifyResult } from '../../shared/types';
+import type { TimebackClient } from '../timeback-client.class';
+/**
+ * Verify the current user with in-flight dedupe and short-lived caching.
+ *
+ * @param timeback - Timeback client instance
+ * @param force - If true, bypass cache and in-flight reuse
+ * @returns Verify result
+ */
+export declare function verifyOnce(timeback: TimebackClient, force: boolean): Promise<TimebackVerifyResult>;
+/**
+ * Get cached verification result if fresh.
+ *
+ * @param timeback - Timeback client instance
+ * @returns Cached result or undefined
+ */
+export declare function getVerifyCache(timeback: TimebackClient): TimebackVerifyResult | undefined;
+/**
+ * Fetch the profile with in-flight dedupe and short-lived caching.
+ *
+ * @param timeback - Timeback client instance
+ * @param force - If true, bypass cache and in-flight reuse
+ * @returns The user's Timeback profile
+ */
+export declare function fetchProfileOnce(timeback: TimebackClient, force: boolean): Promise<TimebackProfile>;
+/**
+ * Get cached profile result if fresh.
+ *
+ * @param timeback - Timeback client instance
+ * @returns Cached profile or undefined
+ */
+export declare function getProfileCache(timeback: TimebackClient): TimebackProfile | undefined;
+//# sourceMappingURL=user-cache.d.ts.map

package/dist/client/lib/user-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-cache.d.ts","sourceRoot":"","sources":["../../../src/client/lib/user-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAkC9D;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC/B,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,OAAO,GACZ,OAAO,CAAC,oBAAoB,CAAC,CAyC/B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,oBAAoB,GAAG,SAAS,CAGzF;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACrC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,OAAO,GACZ,OAAO,CAAC,eAAe,CAAC,CAwC1B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,eAAe,GAAG,SAAS,CAGrF"}