@timeback/sdk 0.1.7 → 0.1.9

package/README.md

@@ -54,8 +54,8 @@ export const timeback = await createTimeback({
 	},
 	identity: {
 		mode: 'sso',
-		clientId: process.env.AWS_COGNITO_CLIENT_ID!,
-		clientSecret: process.env.AWS_COGNITO_CLIENT_SECRET!,
+		clientId: process.env.TIMEBACK_SSO_CLIENT_ID!,
+		clientSecret: process.env.TIMEBACK_SSO_CLIENT_SECRET!,
 		redirectUri: 'http://localhost:3000/api/auth/sso/callback/timeback',
 		onCallbackSuccess: async ({ user, state, redirect }) => {
 			// user.id is the timebackId (canonical stable identifier)
@@ -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
@@ -340,8 +430,8 @@ Uses Timeback as the identity provider via OIDC. When using `createTimeback()`,
 ```typescript
 identity: {
 	mode: 'sso',
-	clientId: process.env.AWS_COGNITO_CLIENT_ID!,
-	clientSecret: process.env.AWS_COGNITO_CLIENT_SECRET!,
+	clientId: process.env.TIMEBACK_SSO_CLIENT_ID!,
+	clientSecret: process.env.TIMEBACK_SSO_CLIENT_SECRET!,
 	redirectUri: 'http://localhost:3000/api/auth/sso/callback/timeback',
 	onCallbackSuccess: async ({ user, idp, state, redirect }) => {
 		// user.id is the timebackId (canonical stable identifier)
@@ -448,8 +538,8 @@ export const timeback = createTimebackIdentity({
 	env: 'production',
 	identity: {
 		mode: 'sso',
-		clientId: process.env.AWS_COGNITO_CLIENT_ID!,
-		clientSecret: process.env.AWS_COGNITO_CLIENT_SECRET!,
+		clientId: process.env.TIMEBACK_SSO_CLIENT_ID!,
+		clientSecret: process.env.TIMEBACK_SSO_CLIENT_SECRET!,
 		onCallbackSuccess: async ({ user, tokens, redirect }) => {
 			// user is raw OIDC userInfo (sub, email, name, picture, etc.)
 			// No Timeback profile enrichment in identity-only 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};

package/dist/chunk-5171mkp2.js

@@ -0,0 +1,2 @@
+import{C as F}from"./chunk-hnf0tart.js";function M(j){let g=j.trim();if(g==="")return"/";let A=g.indexOf("?");if(A===-1)return g;let L=g.slice(0,A);if(L==="")return"/";return L}function X(j){let g=M(j);if(g!==""&&!g.startsWith("/"))g=`/${g}`;if(g==="/"||g==="")return"";if(g.endsWith("/"))return g.slice(0,-1);return g}function Z(j){let g=j.method.toUpperCase(),A=M(j.pathname),L=j.callbackPath?M(j.callbackPath):void 0;if(L&&A===L)return g==="GET"?"identity.callback":null;let N=j.basePath,Q=N!==void 0,J=Q?X(N):void 0,V=(G)=>{if(g==="GET"){if(G===F.IDENTITY.SIGNIN)return"identity.signIn";if(G===F.IDENTITY.CALLBACK)return"identity.callback";if(G===F.IDENTITY.SIGNOUT)return"identity.signOut";if(G===F.USER.ME)return"user.me";if(G===F.USER.VERIFY)return"user.verify"}if(g==="POST"){if(G===F.ACTIVITY)return"activity"}return null};if(Q&&J!==void 0){if(J!==""&&A===J)return null;if(J!==""&&!A.startsWith(`${J}/`))return null;let G=J===""?A:A.slice(J.length),W=G.startsWith("/")?G:`/${G}`;return V(W)}if(g==="GET"){if(A.endsWith(F.IDENTITY.SIGNIN))return"identity.signIn";if(A.endsWith(F.IDENTITY.CALLBACK))return"identity.callback";if(A.endsWith(F.IDENTITY.SIGNOUT))return"identity.signOut";if(A.endsWith(F.USER.ME))return"user.me";if(A.endsWith(F.USER.VERIFY))return"user.verify"}if(g==="POST"){if(A.endsWith(F.ACTIVITY))return"activity"}return null}function _(j){return"handle"in j?j.handle:j}function $(j){return"activity"in j}function C(j){return"user"in j}
+export{M as x,Z as y,_ as z,$ as A,C as B};