@timeback/sdk 0.1.7 → 0.1.8

package/README.md

@@ -212,8 +212,58 @@ function MyComponent() {
 }
 ```
 
+#### Profile Hook
+
+Use `useTimebackProfile` to fetch user profile data. Supports manual and auto-fetch modes:
+
+```tsx
+// Manual fetch
+import { useTimebackProfile } from '@timeback/sdk/react'
+
+function ProfileButton() {
+	const { state, canFetch, fetchProfile } = useTimebackProfile()
+
+	if (state.status === 'loaded') {
+		return <div>XP: {state.profile.xp}</div>
+	}
+
+	return (
+		<button onClick={fetchProfile} disabled={!canFetch}>
+			{state.status === 'loading' ? 'Loading...' : 'Load Profile'}
+		</button>
+	)
+}
+
+// Auto-fetch when verified
+function AutoProfile() {
+	const { state } = useTimebackProfile({ auto: true })
+
+	if (state.status === 'loading') return <div>Loading...</div>
+	if (state.status === 'loaded') return <div>XP: {state.profile.xp}</div>
+
+	return null
+}
+```
+
 ### Vue
 
+#### Profile Composable
+
+```vue
+<script setup>
+import { useTimebackProfile } from '@timeback/sdk/vue'
+
+const { state, canFetch, fetchProfile } = useTimebackProfile()
+</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>
+```
+
 ```vue
 <!-- app.vue -->
 <script setup>
@@ -290,6 +340,22 @@ onUnmounted(() => activity?.end())
 <SignInButton size="lg" />
 ```
 
+#### Profile Store
+
+```svelte
+<script>
+	import { timebackProfile, timebackProfileCanFetch, fetchTimebackProfile } from '@timeback/sdk/svelte'
+</script>
+
+<button onclick={fetchTimebackProfile} disabled={!$timebackProfileCanFetch}>
+	{$timebackProfile.status === 'loading' ? 'Loading...' : 'Load Profile'}
+</button>
+
+{#if $timebackProfile.status === 'loaded'}
+	<div>XP: {$timebackProfile.profile.xp}</div>
+{/if}
+```
+
 ### Solid
 
 ```tsx
@@ -331,6 +397,30 @@ function MyComponent() {
 }
 ```
 
+#### Profile Primitive
+
+```tsx
+import { createTimebackProfile } from '@timeback/sdk/solid'
+import { Show } from 'solid-js'
+
+function ProfileButton() {
+	const { state, canFetch, fetchProfile } = createTimebackProfile()
+
+	return (
+		<Show
+			when={state.status === 'loaded'}
+			fallback={
+				<button onClick={fetchProfile} disabled={!canFetch}>
+					{state.status === 'loading' ? 'Loading...' : 'Load Profile'}
+				</button>
+			}
+		>
+			<div>XP: {state.profile.xp}</div>
+		</Show>
+	)
+}
+```
+
 ## Identity Modes
 
 ### SSO Mode
@@ -535,8 +625,7 @@ await activity.end({
 	correctQuestions: 8,
 	xpEarned: 80,
 	masteredUnits: 1, // optional (default: omitted)
-	attemptNumber: 2, // optional (default: omitted)
-	pctCompleteApp: 67, // optional (default: omitted; clamped to 0–100 by the SDK server handler if present)
+	pctComplete: 67, // optional (default: omitted; clamped to 0–100 by the SDK server handler if present)
 })
 ```
 

package/dist/chunk-07j8zre9.js

@@ -0,0 +1,2 @@
+import{createRequire as k}from"node:module";var g=Object.create;var{getPrototypeOf:h,defineProperty:f,getOwnPropertyNames:i}=Object;var j=Object.prototype.hasOwnProperty;var l=(a,b,c)=>{c=a!=null?g(h(a)):{};let d=b||!a||!a.__esModule?f(c,"default",{value:a,enumerable:!0}):c;for(let e of i(a))if(!j.call(d,e))f(d,e,{get:()=>a[e],enumerable:!0});return d};var m=(a,b)=>()=>(b||a((b={exports:{}}).exports,b),b.exports);var o=k(import.meta.url);
+export{l as M,m as N,o as O};