@timeback/sdk 0.1.7 → 0.1.8

package/dist/client/adapters/svelte/{stores.ts → stores/client.ts}

@@ -1,51 +1,14 @@
 /**
- * Svelte Stores
+ * Timeback Client Store
  *
- * Svelte stores for Timeback SDK reactivity.
+ * Core Svelte store for the Timeback client singleton.
  */
 
-import { TimebackClient } from '@timeback/sdk/client'
-
-/**
- * Minimal Svelte-compatible store interface.
- *
- * This allows the SDK to work without a direct Svelte dependency.
- */
-interface Readable<T> {
-	subscribe: (run: (value: T) => void) => () => void
-}
-
-interface Writable<T> extends Readable<T> {
-	set: (value: T) => void
-	update: (updater: (value: T) => T) => void
-}
+import { writable } from 'svelte/store'
 
-/**
- * Create a minimal writable store implementation.
- *
- * @param initialValue - Initial store value
- * @returns Writable store
- */
-function writable<T>(initialValue: T): Writable<T> {
-	let value = initialValue
-	const subscribers = new Set<(value: T) => void>()
+import { TimebackClient } from '@timeback/sdk/client'
 
-	return {
-		subscribe(run) {
-			subscribers.add(run)
-			run(value)
-			return () => subscribers.delete(run)
-		},
-		set(newValue) {
-			value = newValue
-			subscribers.forEach(fn => fn(value))
-		},
-		update(updater) {
-			value = updater(value)
-			subscribers.forEach(fn => fn(value))
-		},
-	}
-}
+import type { Readable } from 'svelte/store'
 
 let clientInstance: TimebackClient | undefined
 
@@ -61,10 +24,28 @@ function getOrCreateClient(): TimebackClient {
 	return clientInstance
 }
 
+/**
+ * Check if we're running in the browser.
+ *
+ * @returns True if in browser
+ */
+function isBrowser(): boolean {
+	return typeof window !== 'undefined'
+}
+
 /**
  * Internal client store.
  */
-const clientStore = writable<TimebackClient | undefined>(undefined)
+export const clientStore = writable<TimebackClient | undefined>(undefined)
+
+/**
+ * Get the current client instance (for internal use by other stores).
+ *
+ * @returns Current client instance or undefined
+ */
+export function getClientInstance(): TimebackClient | undefined {
+	return clientInstance
+}
 
 /**
  * Initialize the Timeback client.
@@ -95,15 +76,6 @@ export function initTimeback(client?: TimebackClient): void {
 	clientStore.set(getOrCreateClient())
 }
 
-/**
- * Check if we're running in the browser.
- *
- * @returns True if in browser
- */
-function isBrowser(): boolean {
-	return typeof window !== 'undefined'
-}
-
 /**
  * Auto-initialize on first access in browser.
  */

package/dist/client/adapters/svelte/stores/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Svelte Stores
+ *
+ * Svelte stores for Timeback SDK reactivity.
+ */
+export { initTimeback, timeback } from './client';
+export { refreshTimebackVerification, timebackVerification } from './verification';
+export { fetchTimebackProfile, refreshTimebackProfile, timebackProfile, timebackProfileCanFetch, } from './profile';
+export type { TimebackProfileState, TimebackVerificationState } from '../types';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/adapters/svelte/stores/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/client/adapters/svelte/stores/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAGjD,OAAO,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAGlF,OAAO,EACN,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,uBAAuB,GACvB,MAAM,WAAW,CAAA;AAGlB,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAA"}

package/dist/client/adapters/svelte/stores/index.ts

@@ -0,0 +1,22 @@
+/**
+ * Svelte Stores
+ *
+ * Svelte stores for Timeback SDK reactivity.
+ */
+
+// Client
+export { initTimeback, timeback } from './client'
+
+// Verification
+export { refreshTimebackVerification, timebackVerification } from './verification'
+
+// Profile
+export {
+	fetchTimebackProfile,
+	refreshTimebackProfile,
+	timebackProfile,
+	timebackProfileCanFetch,
+} from './profile'
+
+// Types re-exported for convenience
+export type { TimebackProfileState, TimebackVerificationState } from '../types'

package/dist/client/adapters/svelte/stores/profile.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Timeback Profile Store
+ *
+ * Svelte store for user profile state.
+ */
+import type { TimebackProfileState } from '../types';
+import type { Readable } from 'svelte/store';
+/**
+ * Store containing the Timeback profile state.
+ *
+ * Use this to access the current user's Timeback profile.
+ * Call `fetchTimebackProfile()` to manually fetch, or `refreshTimebackProfile()` to force re-fetch.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { timebackProfile, timebackProfileCanFetch, fetchTimebackProfile } from '@timeback/sdk/svelte'
+ * </script>
+ *
+ * <button on:click={fetchTimebackProfile} disabled={!$timebackProfileCanFetch}>
+ *   {$timebackProfile.status === 'loading' ? 'Loading...' : 'Fetch Profile'}
+ * </button>
+ *
+ * {#if $timebackProfile.status === 'loaded'}
+ *   <pre>{JSON.stringify($timebackProfile.profile, null, 2)}</pre>
+ * {/if}
+ * ```
+ */
+export declare const timebackProfile: Readable<TimebackProfileState>;
+/**
+ * Store indicating whether the profile can be fetched.
+ *
+ * True when the user is verified and the client is ready.
+ */
+export declare const timebackProfileCanFetch: Readable<boolean>;
+/**
+ * Manually fetch the Timeback profile.
+ *
+ * No-op if the user is not verified or client is not ready.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { fetchTimebackProfile } from '@timeback/sdk/svelte'
+ * </script>
+ *
+ * <button on:click={fetchTimebackProfile}>Fetch Profile</button>
+ * ```
+ */
+export declare function fetchTimebackProfile(): void;
+/**
+ * Force a re-fetch of the Timeback profile.
+ *
+ * No-op if the user is not verified or client is not ready.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { refreshTimebackProfile } from '@timeback/sdk/svelte'
+ * </script>
+ *
+ * <button on:click={refreshTimebackProfile}>Refresh Profile</button>
+ * ```
+ */
+export declare function refreshTimebackProfile(): void;
+//# sourceMappingURL=profile.d.ts.map

package/dist/client/adapters/svelte/stores/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../../../src/client/adapters/svelte/stores/profile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,oBAAoB,EAA6B,MAAM,UAAU,CAAA;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AA6E5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,oBAAoB,CAAgB,CAAA;AAE3E;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,OAAO,CAAiB,CAAA;AAEvE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAS3C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAS7C"}

package/dist/client/adapters/svelte/stores/profile.ts

@@ -0,0 +1,168 @@
+/**
+ * Timeback Profile Store
+ *
+ * Svelte store for user profile state.
+ */
+
+import { fetchProfileOnce, getProfileCache } from '../../../lib/user-cache'
+import { getClientInstance } from './client'
+import { writable } from 'svelte/store'
+import { verificationStore } from './verification'
+
+import type { TimebackProfileState, TimebackVerificationState } from '../types'
+import type { Readable } from 'svelte/store'
+
+const profileStore = writable<TimebackProfileState>({ status: 'idle' })
+const canFetchStore = writable<boolean>(false)
+let profileInitialized = false
+
+/**
+ * Check if we're running in the browser.
+ *
+ * @returns True if in browser
+ */
+function isBrowser(): boolean {
+	return typeof window !== 'undefined'
+}
+
+/**
+ * Run the profile fetch.
+ *
+ * @param force - If true, bypass cache and force a fresh fetch
+ */
+async function runProfileFetch(force: boolean): Promise<void> {
+	const client = getClientInstance()
+	if (!client) return
+
+	if (!force) {
+		const cached = getProfileCache(client)
+		if (cached) {
+			profileStore.set({ status: 'loaded', profile: cached })
+			return
+		}
+	}
+
+	profileStore.set({ status: 'loading' })
+
+	try {
+		const profile = await fetchProfileOnce(client, force)
+		profileStore.set({ status: 'loaded', profile })
+	} catch (err) {
+		profileStore.set({
+			status: 'error',
+			message: err instanceof Error ? err.message : 'Failed to fetch profile',
+		})
+	}
+}
+
+/**
+ * Update canFetch based on verification state.
+ *
+ * @param verification - Current verification state
+ */
+function updateCanFetch(verification: TimebackVerificationState): void {
+	const can = verification.status === 'verified' && !!getClientInstance()
+	canFetchStore.set(can)
+}
+
+/**
+ * Initialize profile store subscriptions.
+ */
+function initProfile(): void {
+	if (profileInitialized) return
+	profileInitialized = true
+
+	verificationStore.subscribe(verification => {
+		updateCanFetch(verification)
+
+		// Reset to idle if not verified
+		if (verification.status !== 'verified') {
+			profileStore.set({ status: 'idle' })
+		}
+	})
+}
+
+// Auto-init in browser
+if (isBrowser()) {
+	initProfile()
+}
+
+/**
+ * Store containing the Timeback profile state.
+ *
+ * Use this to access the current user's Timeback profile.
+ * Call `fetchTimebackProfile()` to manually fetch, or `refreshTimebackProfile()` to force re-fetch.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { timebackProfile, timebackProfileCanFetch, fetchTimebackProfile } from '@timeback/sdk/svelte'
+ * </script>
+ *
+ * <button on:click={fetchTimebackProfile} disabled={!$timebackProfileCanFetch}>
+ *   {$timebackProfile.status === 'loading' ? 'Loading...' : 'Fetch Profile'}
+ * </button>
+ *
+ * {#if $timebackProfile.status === 'loaded'}
+ *   <pre>{JSON.stringify($timebackProfile.profile, null, 2)}</pre>
+ * {/if}
+ * ```
+ */
+export const timebackProfile: Readable<TimebackProfileState> = profileStore
+
+/**
+ * Store indicating whether the profile can be fetched.
+ *
+ * True when the user is verified and the client is ready.
+ */
+export const timebackProfileCanFetch: Readable<boolean> = canFetchStore
+
+/**
+ * Manually fetch the Timeback profile.
+ *
+ * No-op if the user is not verified or client is not ready.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { fetchTimebackProfile } from '@timeback/sdk/svelte'
+ * </script>
+ *
+ * <button on:click={fetchTimebackProfile}>Fetch Profile</button>
+ * ```
+ */
+export function fetchTimebackProfile(): void {
+	if (!isBrowser()) return
+
+	let canFetch = false
+	canFetchStore.subscribe(v => (canFetch = v))()
+
+	if (!canFetch) return
+
+	void runProfileFetch(false)
+}
+
+/**
+ * Force a re-fetch of the Timeback profile.
+ *
+ * No-op if the user is not verified or client is not ready.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { refreshTimebackProfile } from '@timeback/sdk/svelte'
+ * </script>
+ *
+ * <button on:click={refreshTimebackProfile}>Refresh Profile</button>
+ * ```
+ */
+export function refreshTimebackProfile(): void {
+	if (!isBrowser()) return
+
+	let canFetch = false
+	canFetchStore.subscribe(v => (canFetch = v))()
+
+	if (!canFetch) return
+
+	void runProfileFetch(true)
+}

package/dist/client/adapters/svelte/stores/verification.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Timeback Verification Store
+ *
+ * Svelte store for user verification state.
+ */
+import type { TimebackVerificationState } from '../types';
+import type { Readable } from 'svelte/store';
+export declare const verificationStore: import("svelte/store").Writable<TimebackVerificationState>;
+/**
+ * Store containing the Timeback verification state.
+ *
+ * Use this to check if the current user is verified in Timeback.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { timebackVerification, refreshTimebackVerification } from '@timeback/sdk/svelte'
+ * </script>
+ *
+ * {#if $timebackVerification.status === 'verified'}
+ *   <p>Verified! Timeback ID: {$timebackVerification.timebackId}</p>
+ * {:else if $timebackVerification.status === 'loading'}
+ *   <p>Verifying...</p>
+ * {:else}
+ *   <p>Not verified</p>
+ * {/if}
+ * ```
+ */
+export declare const timebackVerification: Readable<TimebackVerificationState>;
+/**
+ * Force a re-verification of the current user.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { refreshTimebackVerification } from '@timeback/sdk/svelte'
+ * </script>
+ *
+ * <button on:click={refreshTimebackVerification}>Refresh Verification</button>
+ * ```
+ */
+export declare function refreshTimebackVerification(): void;
+//# sourceMappingURL=verification.d.ts.map

package/dist/client/adapters/svelte/stores/verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.d.ts","sourceRoot":"","sources":["../../../../../src/client/adapters/svelte/stores/verification.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAA;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAc5C,eAAO,MAAM,iBAAiB,4DAA6D,CAAA;AA8D3F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,yBAAyB,CAAqB,CAAA;AAE1F;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAGlD"}

package/dist/client/adapters/svelte/stores/verification.ts

@@ -0,0 +1,126 @@
+/**
+ * Timeback Verification Store
+ *
+ * Svelte store for user verification state.
+ */
+
+import { getVerifyCache, verifyOnce } from '../../../lib/user-cache'
+import { clientStore, getClientInstance } from './client'
+import { writable } from 'svelte/store'
+
+import type { TimebackVerifyResult } from '../../../../shared/types'
+import type { TimebackVerificationState } from '../types'
+import type { Readable } from 'svelte/store'
+
+/**
+ * Convert a verify result into a store-friendly state machine.
+ *
+ * @param result - Raw verify result from the SDK client
+ * @returns Mapped verification state
+ */
+function toVerificationState(result: TimebackVerifyResult): TimebackVerificationState {
+	return result.verified
+		? { status: 'verified', timebackId: result.timebackId }
+		: { status: 'unverified' }
+}
+
+export const verificationStore = writable<TimebackVerificationState>({ status: 'loading' })
+let verificationInitialized = false
+
+/**
+ * Check if we're running in the browser.
+ *
+ * @returns True if in browser
+ */
+function isBrowser(): boolean {
+	return typeof window !== 'undefined'
+}
+
+/**
+ * Run the verification check.
+ *
+ * @param force - If true, bypass cache and force a fresh verification
+ */
+async function runVerification(force: boolean): Promise<void> {
+	const client = getClientInstance()
+	if (!client) return
+
+	if (!force) {
+		const cached = getVerifyCache(client)
+		if (cached) {
+			verificationStore.set(toVerificationState(cached))
+			return
+		}
+	}
+
+	verificationStore.set({ status: 'loading' })
+
+	try {
+		const result = await verifyOnce(client, force)
+		verificationStore.set(toVerificationState(result))
+	} catch (err) {
+		verificationStore.set({
+			status: 'error',
+			message: err instanceof Error ? err.message : 'Failed to verify Timeback user',
+		})
+	}
+}
+
+/**
+ * Initialize verification when client becomes available.
+ */
+function initVerification(): void {
+	if (verificationInitialized) return
+	verificationInitialized = true
+
+	// Subscribe to client changes to auto-verify
+	clientStore.subscribe(client => {
+		if (client && isBrowser()) {
+			void runVerification(false)
+		}
+	})
+}
+
+// Auto-init in browser
+if (isBrowser()) {
+	initVerification()
+}
+
+/**
+ * Store containing the Timeback verification state.
+ *
+ * Use this to check if the current user is verified in Timeback.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { timebackVerification, refreshTimebackVerification } from '@timeback/sdk/svelte'
+ * </script>
+ *
+ * {#if $timebackVerification.status === 'verified'}
+ *   <p>Verified! Timeback ID: {$timebackVerification.timebackId}</p>
+ * {:else if $timebackVerification.status === 'loading'}
+ *   <p>Verifying...</p>
+ * {:else}
+ *   <p>Not verified</p>
+ * {/if}
+ * ```
+ */
+export const timebackVerification: Readable<TimebackVerificationState> = verificationStore
+
+/**
+ * Force a re-verification of the current user.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { refreshTimebackVerification } from '@timeback/sdk/svelte'
+ * </script>
+ *
+ * <button on:click={refreshTimebackVerification}>Refresh Verification</button>
+ * ```
+ */
+export function refreshTimebackVerification(): void {
+	if (!isBrowser()) return
+	void runVerification(true)
+}

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"}