@timeback/sdk 0.1.8 → 0.1.10

package/dist/chunk-js665z11.js

@@ -0,0 +1 @@
+import{x as a,y as N}from"./chunk-txwjkpfz.js";import{I as O,K as _,M as x,N as v,O as d,P as q}from"./chunk-nsr7a2dv.js";import{Q as u,S as c}from"./chunk-b8649tw4.js";var J=null,T=!1,C=!1;function g(K){let z=K.replace(/[.+?^${}()|[\]\\]/g,"\\$&").replace(/\*/g,".*");return new RegExp(`^${z}$`)}function K6(){if(J!==null)return;if(J=[],typeof process>"u"||!process.env?.DEBUG){C=!1;return}C=!0;let K=process.env.DEBUG.trim();if(K==="1"||K==="true"||K==="*"){T=!0;return}let Q=K.split(",").map((Z)=>Z.trim()).filter(Boolean);for(let Z of Q)if(Z.startsWith("-"))J.push({regex:g(Z.slice(1)),exclude:!0});else J.push({regex:g(Z),exclude:!1});if(!J.some((Z)=>!Z.exclude)&&J.length>0)T=!0}function p(K){if(K6(),!C)return!0;if(T){if(K){for(let Q of J)if(Q.exclude&&Q.regex.test(K))return!1}return!0}if(!K)return!1;for(let Q of J)if(Q.exclude&&Q.regex.test(K))return!1;for(let Q of J)if(!Q.exclude&&Q.regex.test(K))return!0;return!1}function R(){return typeof globalThis<"u"&&"window"in globalThis}function U(){if(R())return"browser";if(typeof process<"u"&&process.env){if(process.env.CI||process.env.GITHUB_ACTIONS||process.env.GITLAB_CI||process.env.CIRCLECI||process.env.JENKINS_URL||process.env.BUILDKITE)return"ci"}return"terminal"}var k;if(!R())try{k=(await import("node:util")).inspect}catch{}var F={reset:"\x1B[0m",bold:"\x1B[1m",dim:"\x1B[2m",red:"\x1B[31m",yellow:"\x1B[33m",blue:"\x1B[34m",cyan:"\x1B[36m"};function Q6(K){switch(K){case"debug":return F.blue;case"info":return F.cyan;case"warn":return F.yellow;case"error":return F.red}}function z6(K){switch(K){case"debug":return console.debug;case"info":return console.info;case"warn":return console.warn;case"error":return console.error}}function Z6(K){if(k)return k(K,{depth:null,colors:!0,breakLength:80,compact:!1});return JSON.stringify(K,null,2)}var w=(K)=>{let Q=Q6(K.level),z=z6(K.level),Z=K.level.toUpperCase().padEnd(5),$=K.timestamp.toISOString().replace(/\.\d{3}Z$/,""),X=`${F.dim}[${$}]${F.reset}`,Y=`${Q}${Z}${F.reset}`,B=K.scope?`${F.bold}[${K.scope}]${F.reset} `:"",G=`${X} ${Y} ${B}${K.message}`;if(K.context&&Object.keys(K.context).length>0)z(G,Z6(K.context));else z(G)};var $6={debug:"[DEBUG]",info:"[INFO]",warn:"[WARN]",error:"[ERROR]"};function B6(K){return Object.entries(K).map(([Q,z])=>`${Q}=${X6(z)}`).join(" ")}function X6(K){if(typeof K==="string")return K;if(typeof K==="number")return String(K);if(typeof K==="boolean")return String(K);if(K===null)return"null";if(K===void 0)return"undefined";return JSON.stringify(K)}var D=(K)=>{let Q=[];if(Q.push(K.timestamp.toISOString()),Q.push($6[K.level]),K.scope)Q.push(`[${K.scope}]`);if(Q.push(K.message),K.context&&Object.keys(K.context).length>0)Q.push(B6(K.context));console.log(Q.join(" "))};var P=(K)=>{let Q={timestamp:K.timestamp.toISOString(),level:K.level,...K.scope&&{scope:K.scope},msg:K.message};if(K.context&&Object.keys(K.context).length>0)Object.assign(Q,K.context);console.log(JSON.stringify(Q))};var Y6={debug:"color: gray",info:"color: #0ea5e9",warn:"color: #f59e0b",error:"color: #ef4444; font-weight: bold"},H6={debug:"log",info:"info",warn:"warn",error:"error"},S=(K)=>{let Q=H6[K.level],z=Y6[K.level],$=`%c${K.scope?`[${K.scope}]`:""} ${K.message}`;if(K.context&&Object.keys(K.context).length>0)console[Q]($,z,K.context);else console[Q]($,z)};var i=["debug","info","warn","error"];function J6(K){switch(K){case"terminal":return w;case"ci":return D;case"production":return P;case"browser":return S;case"test":return()=>{}}}function F6(){if(typeof process<"u"&&process.env?.DEBUG)return"debug";return"info"}function G6(K,Q){return i.indexOf(K)>=i.indexOf(Q)}class A{scope;minLevel;environment;formatter;defaultContext;constructor(K={}){this.scope=K.scope,this.minLevel=K.minLevel??F6(),this.defaultContext=K.defaultContext??{},this.environment=K.environment??U(),this.formatter=J6(this.environment)}child(K){let Q=this.scope?`${this.scope}:${K}`:K;return new A({scope:Q,minLevel:this.minLevel,environment:this.environment,defaultContext:{...this.defaultContext}})}withContext(K){return new A({scope:this.scope,minLevel:this.minLevel,environment:this.environment,defaultContext:{...this.defaultContext,...K}})}debug(K,Q){this.log("debug",K,Q)}info(K,Q){this.log("info",K,Q)}warn(K,Q){this.log("warn",K,Q)}error(K,Q){this.log("error",K,Q)}log(K,Q,z){if(K==="debug"&&!p(this.scope))return;if(!G6(K,this.minLevel))return;let Z={level:K,message:Q,scope:this.scope,context:z||Object.keys(this.defaultContext).length>0?{...this.defaultContext,...z}:void 0,timestamp:new Date};this.formatter(Z)}}function E(K={}){return new A(K)}var L,l,W6={debug(){},info(){},warn(){},error(){}};function M6(){try{let K=typeof process>"u"?void 0:process.env.DEBUG;return K==="1"||K==="true"}catch{return!1}}var h=new Map;function N6(K,Q){let z=`[${Q}]`;return{debug:(...Z)=>K.debug(`${z} ${Z[0]}`,...Z.slice(1)),info:(...Z)=>K.info(`${z} ${Z[0]}`,...Z.slice(1)),warn:(...Z)=>K.warn(`${z} ${Z[0]}`,...Z.slice(1)),error:(...Z)=>K.error(`${z} ${Z[0]}`,...Z.slice(1))}}function I(K){let Q=h.get(K);if(Q)return Q;if(L)Q=N6(L,K);else{let z=l??(M6()?"debug":"warn");if(z==="silent")Q=W6;else Q=E({scope:K,minLevel:z})}return h.set(K,Q),Q}function j6(K){L=K.logger,l=K.logLevel,h.clear()}function V(K){let Q=`timeback:${K}`;return{debug(z,...Z){I(Q).debug(z,...Z)},info(z,...Z){I(Q).info(z,...Z)},warn(z,...Z){I(Q).warn(z,...Z)},error(z,...Z){I(Q).error(z,...Z)}}}var W=V("sso"),j=V("oidc");var n=new Map;async function b(K){let Q=n.get(K);if(Q)return Q;let z=`${K}/.well-known/openid-configuration`,Z=await fetch(z);if(!Z.ok)throw j.error("Discovery fetch failed",{status:Z.status}),Error(`Failed to fetch OIDC discovery: ${Z.statusText}`);let $=await Z.json();return j.debug("Fetched OIDC discovery document",{authEndpoint:$.authorization_endpoint,tokenEndpoint:$.token_endpoint}),n.set(K,$),$}function f(K){switch(K){case"production":return"https://cognito-idp.us-east-1.amazonaws.com/us-east-1_3uhuoRM3R";case"staging":return"https://cognito-idp.us-east-1.amazonaws.com/us-east-1_5EUwTP9XD";case"local":throw Error("Local environment is not yet supported for OIDC")}}async function y(K){let Q=await b(K.issuer),z=new URL(Q.authorization_endpoint);return z.searchParams.set("response_type","code"),z.searchParams.set("client_id",K.clientId),z.searchParams.set("redirect_uri",K.redirectUri),z.searchParams.set("scope","openid profile email"),z.searchParams.set("state",K.state),z.toString()}async function A6(K){let Q=await b(K.issuer),z=await fetch(Q.token_endpoint,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:new URLSearchParams({grant_type:"authorization_code",client_id:K.clientId,client_secret:K.clientSecret,code:K.code,redirect_uri:K.redirectUri})});if(!z.ok){let $=await z.text();throw j.error("Token exchange failed",{status:z.status,body:$}),Error(`Token exchange failed: ${z.status} ${$}`)}let Z=await z.json();return j.debug("Received tokens from IdP",{expiresIn:Z.expires_in}),Z}async function V6(K){let Q=await b(K.issuer),z=await fetch(Q.userinfo_endpoint,{headers:{Authorization:`Bearer ${K.accessToken}`}});if(!z.ok)throw Error(`UserInfo request failed: ${z.statusText}`);return z.json()}import{TimebackClient as O6}from"@timeback/core";var M=V("resolve");class H extends Error{code;constructor(K,Q){super(K);this.code=Q;this.name="TimebackUserResolutionError"}}function q6(K){switch(K.code){case"timeback_user_ambiguous":return 409;case"timeback_user_not_found":return 404;default:return 502}}function _6(K){return{sub:K.sub,email:K.email,firstName:K.given_name,lastName:K.family_name,pictureUrl:K.picture}}async function t(K,Q){let Z=(await K.oneroster.users.list({where:{email:Q},limit:2})).data;if(Z.length===0)throw M.warn("No Timeback user found for email",{email:N(Q)}),new H(`No Timeback user found with email: ${Q}`,"timeback_user_not_found");if(Z.length>1)throw M.error("Multiple Timeback users found for email",{email:N(Q),count:Z.length}),new H(`Multiple Timeback users found with email: ${Q}`,"timeback_user_ambiguous");let $=Z[0];if(!$.sourcedId)throw new H("Timeback user is missing sourcedId","timeback_user_lookup_failed");return $}async function w6(K){let{env:Q,apiCredentials:z,userInfo:Z}=K;if(!Z.email)throw M.error("Missing email in IdP user info",{sub:Z.sub}),new H("IdP did not return an email address, which is required to resolve Timeback identity","missing_email");let $=Z.email;M.debug("Resolving Timeback user by email",{email:N($),env:Q});let X=K.client,Y=X??new O6({env:O(Q),auth:{clientId:z.clientId,clientSecret:z.clientSecret}});try{let B=await t(Y,$);return{...{id:B.sourcedId,email:B.email??$,name:a(B.givenName,B.familyName),school:B.primaryOrg?{id:B.primaryOrg.sourcedId,name:B.primaryOrg.name??B.primaryOrg.sourcedId}:void 0,grade:B.grades?.length?Math.max(...B.grades):void 0},claims:_6(Z)}}catch(B){if(B instanceof H)throw B;let G=B instanceof Error?B.message:"Unknown error";throw M.error("Failed to lookup Timeback user",{email:N($),error:G}),new H(`Failed to lookup Timeback user: ${G}`,"timeback_user_lookup_failed")}finally{if(!X)Y.close()}}async function D6(K){let{email:Q,client:z}=K;M.debug("Looking up Timeback user ID by email",{email:N(Q)});try{return(await t(z,Q)).sourcedId}catch(Z){if(Z instanceof H)throw Z;let $=Z instanceof Error?Z.message:"Unknown error";throw M.error("Failed to lookup Timeback user",{email:N(Q),error:$}),new H(`Failed to lookup Timeback user: ${$}`,"timeback_user_lookup_failed")}}function m(K,Q,z,Z){return{error:K,errorCode:Q,state:z,req:Z,redirect:x,json:_}}function o(K){try{return d(K)}catch{W.warn("Failed to decode state");return}}function P6(K,Q,z,Z,$){let X=Q.searchParams.get("error_description");W.error("IdP returned error",{error:K,description:X});let Y=Error(X??K);if($)return $(m(Y,K,z,Z));return _({error:K},400)}function S6(K,Q,z){W.error("Missing authorization code in callback");let Z=Error("Missing authorization code");if(z)return z(m(Z,"missing_code",K,Q));return _({error:"Missing authorization code"},400)}async function I6(K){let{req:Q,env:z,clientId:Z,buildState:$}=K,X=K.issuer??f(z),Y=new URL(Q.url),B=K.redirectUri;if(!B){let e=Y.pathname.replace(q.IDENTITY.SIGNIN,"");B=`${Y.origin}${e}${q.IDENTITY.CALLBACK}`}W.debug("SSO sign-in initiated",{env:z,issuer:X,clientId:Z,redirectUri:B});let G=$?$({req:Q,url:Y}):{},s=v(G),r=await y({issuer:X,clientId:Z,redirectUri:B,state:s});return x(r)}function x6(K){let Q=new URL(K.url),z=Q.searchParams.get("code"),Z=Q.searchParams.get("error"),$=Q.searchParams.get("state");W.debug("Received callback from IdP",{hasCode:!!z,error:Z});let X=$?o($):void 0;return{url:Q,code:z,errorParam:Z,state:X}}function T6(K,Q){if(Q)return Q;let z=K.pathname.replace(q.IDENTITY.CALLBACK,"");return`${K.origin}${z}${q.IDENTITY.CALLBACK}`}function C6(K,Q){let z=K.totalQuestions!==void 0,Z=K.correctQuestions!==void 0;if(z!==Z){Q.addIssue({code:"custom",message:"totalQuestions and correctQuestions must be provided together."});return}if(z&&Z){let{correctQuestions:$,totalQuestions:X}=K;if($>X)Q.addIssue({code:"custom",message:"correctQuestions cannot exceed totalQuestions."})}}function R6(K,Q,z){let Z=O(z),$=Q.overrides?.[Z]?.sensor??Q.sensor??K.sensor;if(!$){let X=Q.overrides?.[Z]?.launchUrl??Q.launchUrl??K.launchUrl;if(X)try{$=new URL(X).origin}catch{}}return $}function U6(K,Q,z){if(!Q?.onRequestStart&&!Q?.onRequestEnd)return z;return async(Z)=>{await Q.onRequestStart?.({handler:K});let $=Date.now(),X;try{X=await z(Z)}catch(Y){throw await Q.onRequestEnd?.({handler:K,durationMs:Date.now()-$,status:500}),Y}return await Q.onRequestEnd?.({handler:K,durationMs:Date.now()-$,status:X.status}),X}}export{j6 as e,V as f,W as g,f as h,A6 as i,V6 as j,H as k,q6 as l,w6 as m,D6 as n,m as o,P6 as p,S6 as q,I6 as r,x6 as s,T6 as t,C6 as u,R6 as v,U6 as w};

package/dist/chunk-nsr7a2dv.js

@@ -0,0 +1,2 @@
+import{createHash as C}from"node:crypto";function J(q){return{course:q,component:`${q}-component`,resource:`${q}-resource`,componentResource:`${q}-cr`}}function K(q){return C("sha256").update(q).digest("hex")}function L(q){if(q==="local"||q==="staging")return"staging";return"production"}function M(q){if(q==="production"||q==="local"||q==="staging")return q;return"staging"}function F(q,w=200,z){let A=new Headers(z);return A.set("Content-Type","application/json"),new Response(JSON.stringify(q),{status:w,headers:A})}function N(q,w,z,A){let B={code:q,message:w};if(A?.details!==void 0)B.details=A.details;return F({...A?.fields,error:B},z)}function O(q,w){let z=new Headers(w);return z.set("Location",q),new Response(null,{status:302,headers:z})}function P(q){let w=JSON.stringify(q);return btoa(w).replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/,"")}function Q(q){let w=q.replace(/-/g,"+").replace(/_/g,"/"),z=atob(w);return JSON.parse(z)}var T={ACTIVITY:"/activity",ACTIVITY_HEARTBEAT:"/activity/heartbeat",ACTIVITY_SUBMIT:"/activity/submit",IDENTITY:{SIGNIN:"/identity/signin",SIGNOUT:"/identity/signout",CALLBACK:"/identity/callback"},USER:{ME:"/user/me",VERIFY:"/user/verify"}};
+export{J as G,K as H,L as I,M as J,F as K,N as L,O as M,P as N,Q as O,T as P};

package/dist/chunk-sgcwg4j6.js

@@ -0,0 +1 @@
+import{z as H}from"zod/v4";import{z as _}from"zod/v4";var jZ=/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/,x=_.string().min(1).regex(jZ,"must be a valid ISO 8601 datetime"),k=_.string().min(1).regex(/^\d{4}-\d{2}-\d{2}$/,"must be a valid ISO 8601 date (YYYY-MM-DD)"),L=_.enum(["Reading","Language","Vocabulary","Social Studies","Writing","Science","FastMath","Math","None","Other"]).meta({id:"TimebackSubject",description:"Subject area"}),F=_.union([_.literal(-1),_.literal(0),_.literal(1),_.literal(2),_.literal(3),_.literal(4),_.literal(5),_.literal(6),_.literal(7),_.literal(8),_.literal(9),_.literal(10),_.literal(11),_.literal(12),_.literal(13)]).meta({id:"TimebackGrade",description:"Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"}),l=_.enum(["exempt","fully graded","not submitted","partially graded","submitted"]),T=_.enum(["department","school","district","local","state","national"]),C=_.enum(["administrator","aide","guardian","parent","proctor","relative","student","teacher"]),R=_.enum(["administrator","proctor","student","teacher"]),u=_.enum(["qti","text","audio","video","interactive","visual","course-material","assessment-bank"]),d=_.enum(["qti-test","qti-question","qti-stimulus","qti-test-bank"]),N=_.enum(["unit","course","resource-collection"]),c=_.enum(["choice","order","associate","match","hotspot","hottext","select-point","graphic-order","graphic-associate","graphic-gap-match","text-entry","extended-text","inline-choice","upload","slider","drawing","media","custom"]),p=_.enum(["easy","medium","hard"]),E=_.array(_.object({source:_.string(),learningObjectiveIds:_.array(_.string())})),y=_.object({consecutive_failures:_.number().int().min(1).optional(),stagnation_limit:_.number().int().min(1).optional()}).optional(),Wq=_.enum(["powerpath-100","quiz","test-out","placement","unit-test","alpha-read-article"]).nullable(),Xq=_.object({imsx_codeMajor:_.enum(["failure","success"]),imsx_severity:_.enum(["error","warning","status"]),imsx_description:_.string(),imsx_CodeMinor:_.object({imsx_codeMinorField:_.array(_.object({imsx_codeMinorFieldName:_.string(),imsx_codeMinorFieldValue:_.string()}))}).optional()});var PZ=H.object({staging:H.string().meta({description:"Course ID in staging environment"}).optional(),production:H.string().meta({description:"Course ID in production environment"}).optional()}).meta({id:"CourseIds",description:"Environment-specific course IDs (populated by sync)"}),GZ=H.enum(["base","hole-filling","optional"]).meta({id:"CourseType",description:"Course classification type"}),BZ=H.enum(["draft","testing","published","deactivated"]).meta({id:"PublishStatus",description:"Course publication status"}),AZ=H.object({dailyXp:H.number().int().positive().meta({description:"Target XP to earn per day"}).optional(),dailyLessons:H.number().int().positive().meta({description:"Target lessons to complete per day"}).optional(),dailyActiveMinutes:H.number().int().positive().meta({description:"Target active learning minutes per day"}).optional(),dailyAccuracy:H.number().int().min(0).max(100).meta({description:"Target accuracy percentage (0-100)"}).optional(),dailyMasteredUnits:H.number().int().positive().meta({description:"Target units to master per day"}).optional()}).meta({id:"CourseGoals",description:"Daily learning goals for a course"}),hZ=H.object({totalXp:H.number().int().positive().meta({description:"Total XP available in the course"}).optional(),totalLessons:H.number().int().positive().meta({description:"Total number of lessons/activities"}).optional(),totalGrades:H.number().int().positive().meta({description:"Total grade levels covered"}).optional()}).meta({id:"CourseMetrics",description:"Aggregate metrics for a course"}),g=H.object({courseType:GZ.optional(),isSupplemental:H.boolean().meta({description:"Whether this is supplemental to a base course"}).optional(),isCustom:H.boolean().meta({description:"Whether this is a custom course for an individual student"}).optional(),publishStatus:BZ.optional(),contactEmail:H.email().meta({description:"Contact email for course issues"}).optional(),primaryApp:H.string().meta({description:"Primary application identifier"}).optional(),goals:AZ.optional(),metrics:hZ.optional()}).meta({id:"CourseMetadata",description:"Course metadata (matches API metadata object)"}),m=H.object({courseCode:H.string().meta({description:"Course code (e.g., 'MATH101')"}).optional(),level:H.string().meta({description:"Course level (e.g., 'AP', 'Honors')"}).optional(),metadata:g.optional()}).meta({id:"CourseDefaults",description:"Default properties that apply to all courses unless overridden"}),s=H.object({level:H.string().meta({description:"Course level for this environment"}).optional(),sensor:H.url().meta({description:"Caliper sensor endpoint URL for this environment"}).optional(),launchUrl:H.url().meta({description:"LTI launch URL for this environment"}).optional(),metadata:g.optional()}).meta({id:"CourseEnvOverrides",description:"Environment-specific course overrides (non-identity fields)"}),OZ=H.object({staging:s.meta({description:"Overrides for staging environment"}).optional(),production:s.meta({description:"Overrides for production environment"}).optional()}).meta({id:"CourseOverrides",description:"Per-environment course overrides"}),vZ=m.extend({subject:L.meta({description:"Subject area for this course"}),grade:F.meta({description:"Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"}).optional(),ids:PZ.nullable().optional(),sensor:H.url().meta({description:"Caliper sensor endpoint URL for this course"}).optional(),launchUrl:H.url().meta({description:"LTI launch URL for this course"}).optional(),overrides:OZ.optional()}).meta({id:"CourseConfig",description:"Configuration for a single course. Must have either grade or courseCode (or both)."}),Hq=H.object({$schema:H.string().meta({description:"JSON Schema reference for editor support"}).optional(),name:H.string().min(1,"App name is required").meta({description:"Display name for your app"}),defaults:m.meta({description:"Default properties applied to all courses"}).optional(),courses:H.array(vZ).min(1,"At least one course is required").meta({description:"Courses available in this app"}),sensor:H.url().meta({description:"Default Caliper sensor endpoint URL for all courses"}).optional(),launchUrl:H.url().meta({description:"Default LTI launch URL for all courses"}).optional()}).meta({id:"TimebackConfig",title:"Timeback Config",description:"Configuration schema for timeback.config.json files"}).refine((U)=>{return U.courses.every((j)=>j.grade!==void 0||j.courseCode!==void 0)},{message:"Each course must have either a grade or a courseCode",path:["courses"]}).refine((U)=>{let v=U.courses.filter((h)=>h.grade!==void 0).map((h)=>`${h.subject}:${h.grade}`);return new Set(v).size===v.length},{message:"Duplicate (subject, grade) pair found; each must be unique",path:["courses"]}).refine((U)=>{let v=U.courses.filter((h)=>h.courseCode!==void 0).map((h)=>h.courseCode);return new Set(v).size===v.length},{message:"Duplicate courseCode found; each must be unique",path:["courses"]}).refine((U)=>{return U.courses.every((j)=>{if(j.sensor!==void 0||U.sensor!==void 0)return!0;return[j.launchUrl,U.launchUrl,j.overrides?.staging?.launchUrl,j.overrides?.production?.launchUrl].filter(Boolean).length>0})},{message:"Each course must have an effective sensor. Either set `sensor` explicitly (top-level or per-course), or provide a `launchUrl` so sensor can be derived from its origin.",path:["courses"]});import{z as J}from"zod/v4";var D=J.object({id:J.string(),type:J.literal("TimebackUser"),email:J.string()}),Q=J.object({id:J.string(),type:J.literal("TimebackActivityContext"),subject:L,app:J.object({name:J.string()}),activity:J.object({id:J.string().optional(),name:J.string()}).strict().optional(),course:J.object({id:J.string().optional(),name:J.string()}).strict().optional(),process:J.boolean().optional()}),S=J.object({"@context":J.literal("http://purl.imsglobal.org/ctx/caliper/v1p2"),id:J.string(),type:J.string(),eventTime:x,profile:J.literal("TimebackProfile"),actor:D,action:J.string(),object:Q,edApp:J.object({id:J.string(),name:J.string().optional()}).optional()}),o=J.object({type:J.enum(["totalQuestions","correctQuestions","xpEarned","masteredUnits"]),value:J.number()}),IZ=J.object({id:J.string(),type:J.literal("TimebackActivityMetricsCollection"),attempt:J.number().optional(),items:J.array(o),extensions:J.record(J.string(),J.unknown()).optional()}),CZ=S.extend({type:J.literal("ActivityEvent"),action:J.literal("Completed"),generated:IZ}),r=J.object({type:J.enum(["active","inactive","waste","unknown","anti-pattern"]),value:J.number(),subType:J.string().optional()}),kZ=J.object({id:J.string(),type:J.literal("TimebackTimeSpentMetricsCollection"),items:J.array(r)}),DZ=S.extend({type:J.literal("TimeSpentEvent"),action:J.literal("SpentTime"),generated:kZ}),Fq=J.object({actor:D,object:Q,metrics:J.array(o).min(1,"metrics must contain at least one metric"),eventTime:x.optional(),metricsId:J.string().optional(),id:J.string().optional(),extensions:J.record(J.string(),J.unknown()).optional(),edApp:J.union([J.string(),J.record(J.string(),J.unknown())]).optional(),session:J.union([J.string(),J.record(J.string(),J.unknown())]).optional(),attempt:J.number().int().min(1).optional(),generatedExtensions:J.object({pctCompleteApp:J.number().optional()}).loose().optional()}).strict(),Lq=J.object({actor:D,object:Q,metrics:J.array(r).min(1,"metrics must contain at least one metric"),eventTime:x.optional(),metricsId:J.string().optional(),id:J.string().optional(),extensions:J.record(J.string(),J.unknown()).optional(),edApp:J.union([J.string(),J.record(J.string(),J.unknown())]).optional(),session:J.union([J.string(),J.record(J.string(),J.unknown())]).optional()}).strict(),QZ=J.union([CZ,DZ]),Uq=J.object({sensor:J.string(),sendTime:x,dataVersion:J.literal("http://purl.imsglobal.org/ctx/caliper/v1p2"),data:J.array(QZ)}),MZ=J.enum(["AnnotationProfile","AssessmentProfile","ToolUseProfile","GeneralProfile","FeedbackProfile","MediaProfile","SurveyProfile","ResourceManagementProfile","ForumProfile","AssignableProfile","GradingProfile","ReadingProfile","SessionProfile","SearchProfile","ToolLaunchProfile","TimebackProfile"]),B=J.union([J.string(),J.record(J.string(),J.unknown())]),fZ=J.object({id:J.string(),type:J.string(),extensions:J.object({email:J.email()}).loose()}).strict(),a=J.object({"@context":J.string().optional(),id:J.string(),type:J.string(),actor:J.union([J.string(),fZ,D]),action:J.string(),object:B,eventTime:x,profile:MZ,edApp:B.optional(),generated:B.optional(),target:B.optional(),referrer:B.optional(),group:B.optional(),membership:B.optional(),session:B.optional(),federatedSession:B.optional(),extensions:J.record(J.string(),J.unknown()).optional()}).strict(),jq=J.object({sensor:J.string().min(1,"sensor must be a non-empty string"),sendTime:x,dataVersion:J.literal("http://purl.imsglobal.org/ctx/caliper/v1p2"),data:J.array(a).min(1,"data must contain at least one event")}),Pq=J.object({sensor:J.string().min(1,"sensor must be a non-empty string"),events:J.array(a).min(1,"events must contain at least one event")}),Gq=J.object({limit:J.number().int().positive().optional(),offset:J.number().int().min(0).optional(),sensor:J.string().min(1).optional(),startDate:x.optional(),endDate:x.optional(),actorId:J.string().min(1).optional(),actorEmail:J.email().optional()}).strict();import{z as X}from"zod/v4";var G=X.union([x,k]),Oq=X.object({id:X.string(),role:X.string(),beginDate:G.nullable(),endDate:G.nullable(),metadata:X.object({goals:X.object({dailyXp:X.number().optional()}).optional(),metrics:X.object({totalXp:X.number().optional(),totalLessons:X.number().optional()}).optional()}).optional(),course:X.object({id:X.string(),title:X.string(),subjects:X.array(X.string()).nullable(),grades:X.array(X.string()).nullable()}),school:X.object({id:X.string(),name:X.string()})}),bZ=X.object({activityMetrics:X.object({xpEarned:X.number(),totalQuestions:X.number(),correctQuestions:X.number(),masteredUnits:X.number()}),timeSpentMetrics:X.object({activeSeconds:X.number(),inactiveSeconds:X.number(),wasteSeconds:X.number()}),apps:X.array(X.string())}),lZ=X.record(X.string(),X.record(X.string(),bZ)),vq=X.object({message:X.string(),enrollmentId:X.string(),startDate:G,endDate:G,facts:lZ,factsByApp:X.unknown()}),A=X.string().trim().min(1),i=X.object({email:X.email().optional(),studentId:A.optional()}).superRefine((U,j)=>{if(!U.email&&!U.studentId)j.addIssue({code:X.ZodIssueCode.custom,message:"must provide either email or studentId",path:["email"]}),j.addIssue({code:X.ZodIssueCode.custom,message:"must provide either email or studentId",path:["studentId"]})}),Iq=X.object({subject:A,grade:A,courseId:A,orgSourcedId:A.optional()});var Cq=X.object({userId:A}),kq=X.object({sourcedId:A.optional(),role:R.optional(),beginDate:G.optional(),metadata:X.record(X.string(),X.unknown()).optional()}),Dq=X.object({fields:X.string().optional(),limit:X.number().int().positive().optional(),offset:X.number().int().nonnegative().optional(),sort:X.string().optional(),orderBy:X.enum(["asc","desc"]).optional(),filter:X.string().optional(),search:X.string().optional(),roles:X.array(C).min(1),orgSourcedIds:X.array(A).optional()}),Qq=i.extend({startDate:G,endDate:G,timezone:X.string().optional()}),Mq=i.extend({weekDate:G,timezone:X.string().optional()}),fq=X.object({enrollmentId:A,startDate:G.optional(),endDate:G.optional(),timezone:X.string().optional()});import{z as q}from"zod/v4";var Y=q.string().min(1),V=q.enum(["active","tobedeleted"]),w=q.record(q.string(),q.unknown()).nullable().optional(),$=q.object({sourcedId:Y,type:q.string().optional(),href:q.string().optional()}).strict(),P=q.union([k,x]),TZ=q.object({roleType:q.enum(["primary","secondary"]),role:C,org:$,userProfile:q.string().optional(),metadata:w,beginDate:P.optional(),endDate:P.optional()}).strict(),Rq=q.object({sourcedId:Y.describe("sourcedId must be a non-empty string"),status:V.optional(),enabledUser:q.boolean(),givenName:Y.describe("givenName must be a non-empty string"),familyName:Y.describe("familyName must be a non-empty string"),middleName:Y.optional(),username:Y.optional(),email:q.email().optional(),roles:q.array(TZ).min(1,"roles must include at least one role"),userIds:q.array(q.object({type:Y,identifier:Y}).strict()).optional(),agents:q.array($).optional(),grades:q.array(F).optional(),identifier:Y.optional(),sms:Y.optional(),phone:Y.optional(),pronouns:Y.optional(),password:Y.optional(),metadata:w}).strict(),uq=q.object({sourcedId:Y.describe("sourcedId must be a non-empty string").optional(),status:V.optional(),title:Y.describe("title must be a non-empty string"),org:$,courseCode:Y.optional(),subjects:q.array(L).optional(),grades:q.array(F).optional(),level:Y.optional(),metadata:w}).strict(),dq=q.object({sourcedId:Y.describe("sourcedId must be a non-empty string").optional(),status:V.optional(),title:Y.describe("title must be a non-empty string"),terms:q.array($).min(1,"terms must have at least one item"),course:$,org:$,classCode:Y.optional(),classType:q.enum(["homeroom","scheduled"]).optional(),location:Y.optional(),grades:q.array(F).optional(),subjects:q.array(L).optional(),subjectCodes:q.array(Y).optional(),periods:q.array(Y).optional(),metadata:w}).strict(),n=q.enum(["true","false"]),Nq=q.object({sourcedId:Y.describe("sourcedId must be a non-empty string").optional(),status:V.optional(),user:$,class:$,school:$.optional(),role:C,primary:n.optional(),beginDate:P.optional(),endDate:P.optional(),metadata:w}).strict(),cq=q.object({sourcedId:Y.optional(),title:Y.describe("title must be a non-empty string"),status:V,weight:q.number().nullable().optional(),metadata:w}).strict(),pq=q.object({sourcedId:Y.optional(),title:Y.describe("title must be a non-empty string"),class:$,school:$,category:$,assignDate:P,dueDate:P,status:V,description:q.string().optional(),resultValueMin:q.number().nullable().optional(),resultValueMax:q.number().nullable().optional(),scoreScale:$.optional(),metadata:w}).strict(),Eq=q.object({sourcedId:Y.optional(),lineItem:$,student:$,class:$.optional(),scoreDate:P,scoreStatus:q.enum(["exempt","fully graded","not submitted","partially graded","submitted"]),score:q.number().nullable().optional(),textScore:q.string().nullable().optional(),status:V,comment:q.string().nullable().optional(),metadata:w}).strict(),yq=q.object({sourcedId:Y.optional(),title:Y.describe("title must be a non-empty string"),status:V.optional(),type:q.string().optional(),class:$.optional(),course:$.nullable().optional(),scoreScaleValue:q.array(q.object({itemValueLHS:Y,itemValueRHS:Y,value:q.string().optional(),description:q.string().optional()}).strict()).optional(),minScore:q.number().optional(),maxScore:q.number().optional(),metadata:w}).strict(),sq=q.object({sourcedId:Y.optional(),status:V.optional(),dateLastModified:x.optional(),title:Y.describe("title must be a non-empty string"),description:q.string().nullable().optional(),class:$.nullable().optional(),parentAssessmentLineItem:$.nullable().optional(),scoreScale:$.nullable().optional(),resultValueMin:q.number().nullable().optional(),resultValueMax:q.number().nullable().optional(),component:$.nullable().optional(),componentResource:$.nullable().optional(),learningObjectiveSet:q.array(q.object({source:q.string(),learningObjectiveIds:q.array(q.string())})).optional().nullable(),course:$.nullable().optional(),metadata:w}).strict(),RZ=q.object({learningObjectiveId:q.string(),score:q.number().optional(),textScore:q.string().optional()}),uZ=q.array(q.object({source:q.string(),learningObjectiveResults:q.array(RZ)})),gq=q.object({sourcedId:Y.optional(),status:V.optional(),dateLastModified:x.optional(),metadata:w,assessmentLineItem:$,student:$,score:q.number().nullable().optional(),textScore:q.string().nullable().optional(),scoreDate:q.string().datetime(),scoreScale:$.nullable().optional(),scorePercentile:q.number().nullable().optional(),scoreStatus:q.enum(["exempt","fully graded","not submitted","partially graded","submitted"]),comment:q.string().nullable().optional(),learningObjectiveSet:uZ.nullable().optional(),inProgress:q.string().nullable().optional(),incomplete:q.string().nullable().optional(),late:q.string().nullable().optional(),missing:q.string().nullable().optional()}).strict(),mq=q.object({sourcedId:Y.optional(),status:V.optional(),name:Y.describe("name must be a non-empty string"),type:T,identifier:Y.optional(),parent:$.optional(),metadata:w}).strict(),Sq=q.object({sourcedId:Y.optional(),status:V.optional(),name:Y.describe("name must be a non-empty string"),type:q.literal("school").optional(),identifier:Y.optional(),parent:$.optional(),metadata:w}).strict(),oq=q.object({sourcedId:Y.describe("sourcedId must be a non-empty string"),status:V,title:Y.describe("title must be a non-empty string"),startDate:P,endDate:P,type:q.enum(["gradingPeriod","semester","schoolYear","term"]),schoolYear:Y.describe("schoolYear must be a non-empty string"),org:$,parent:$.optional(),children:q.array($).optional(),metadata:w}).strict(),rq=q.object({sourcedId:Y.optional(),title:Y.describe("title must be a non-empty string"),courseComponent:$,resource:$,status:V,metadata:w}).strict(),aq=q.object({sourcedId:Y.optional(),title:Y.describe("title must be a non-empty string"),course:$,status:V,metadata:w}).strict(),iq=q.object({sourcedId:Y.describe("sourcedId must be a non-empty string"),role:q.enum(["student","teacher"]),primary:n.optional(),beginDate:P.optional(),endDate:P.optional(),metadata:w}).strict(),nq=q.object({agentSourcedId:Y.describe("agentSourcedId must be a non-empty string")}).strict(),eq=q.object({type:Y.describe("type must be a non-empty string"),username:Y.describe("username must be a non-empty string"),password:q.string().optional(),metadata:w}).strict(),zq=q.object({sourcedId:Y.describe("sourcedId must be a non-empty string")}).loose(),O=q.object({type:u,subject:L.nullish(),grades:q.array(F).nullish(),language:q.string().nullish(),xp:q.number().nullish(),url:q.url().nullish(),keywords:q.array(q.string()).nullish(),learningObjectiveSet:E.nullish(),lessonType:q.string().nullish()}).passthrough(),dZ=O.extend({type:q.literal("qti"),subType:d,questionType:c.optional(),difficulty:p.optional()}),NZ=O.extend({type:q.literal("text"),format:q.string(),author:q.string().optional(),pageCount:q.number().optional()}),cZ=O.extend({type:q.literal("audio"),duration:q.string().regex(/^\d{2}:\d{2}:\d{2}(\.\d{2})?$/).optional(),format:q.string(),speaker:q.string().optional()}),pZ=O.extend({type:q.literal("video"),duration:q.string().regex(/^\d{2}:\d{2}:\d{2}(\.\d{2})?$/).optional(),captionsAvailable:q.boolean().optional(),format:q.string()}),EZ=O.extend({type:q.literal("interactive"),launchUrl:q.url().optional(),toolProvider:q.string().optional(),instructionalMethod:q.string().optional(),courseIdOnFail:q.string().nullable().optional(),fail_fast:y}),yZ=O.extend({type:q.literal("visual"),format:q.string(),resolution:q.string().optional()}),sZ=O.extend({type:q.literal("course-material"),subType:N,author:q.string().optional(),format:q.string(),instructionalMethod:q.string().optional()}),gZ=O.extend({type:q.literal("assessment-bank"),resources:q.array(q.string())}),mZ=q.discriminatedUnion("type",[dZ,NZ,cZ,pZ,EZ,yZ,sZ,gZ]),tq=q.object({sourcedId:Y.optional(),title:Y.describe("title must be a non-empty string"),vendorResourceId:Y.describe("vendorResourceId must be a non-empty string"),roles:q.array(q.enum(["primary","secondary"])).optional(),importance:q.enum(["primary","secondary"]).optional(),vendorId:q.string().optional(),applicationId:q.string().optional(),status:V.optional(),metadata:mZ.nullable().optional()}).strict(),SZ=q.object({url:Y.describe("courseStructure.url must be a non-empty string"),skillCode:Y.describe("courseStructure.skillCode must be a non-empty string"),lessonCode:Y.describe("courseStructure.lessonCode must be a non-empty string"),title:Y.describe("courseStructure.title must be a non-empty string"),"unit-title":Y.describe("courseStructure.unit-title must be a non-empty string"),status:Y.describe("courseStructure.status must be a non-empty string"),xp:q.number()}).loose(),ZJ=q.object({course:q.object({sourcedId:Y.describe("course.sourcedId must be a non-empty string").optional(),title:Y.describe("course.title must be a non-empty string"),org:$,status:V,metadata:w}).strict(),courseStructure:q.record(q.string(),SZ)}).strict(),oZ=q.object({student:$}).loose(),qJ=q.array(oZ).min(1,"results must have at least one item");import{z as K}from"zod/v4";var W=K.string().trim().min(1),rZ=K.enum(["edulastic","mastery-track"]),aZ=K.enum(["powerpath-100","quiz","test-out","placement","unit-test","alpha-read-article"]),z=K.array(F),t=K.record(K.string(),K.unknown()).optional(),ZZ=K.object({courseId:W,lessonTitle:W.optional(),launchUrl:K.url().optional(),toolProvider:rZ,unitTitle:W.optional(),courseComponentSourcedId:W.optional(),vendorId:W.optional(),description:W.optional(),resourceMetadata:t.nullable().optional(),grades:z}),XJ=ZZ.extend({lessonType:K.literal("test-out"),xp:K.number()}),YJ=ZZ.extend({lessonType:K.literal("placement"),courseIdOnFail:W.optional(),xp:K.number().optional()});var e=K.object({courseId:W,lessonType:aZ,lessonTitle:W.optional(),unitTitle:W.optional(),courseComponentSourcedId:W.optional(),resourceMetadata:t.nullable().optional(),xp:K.number().optional(),grades:z.optional(),courseIdOnFail:W.optional()}),_J=K.union([e.extend({testType:K.literal("qti"),qti:K.object({url:K.url(),title:W.optional(),metadata:K.record(K.string(),K.unknown()).optional()})}),e.extend({testType:K.literal("assessment-bank"),assessmentBank:K.object({resources:K.array(K.object({url:K.url(),title:W.optional(),metadata:K.record(K.string(),K.unknown()).optional()}))})})]),$J=K.object({student:W,lesson:W}),HJ=K.object({student:W,lesson:W}),wJ=K.object({courseId:W,userId:W,classId:W.optional()}),I=K.object({type:K.enum(["component","resource"]),id:W}),iZ=K.union([K.object({type:K.literal("set-skipped"),payload:K.object({target:I,value:K.boolean()})}),K.object({type:K.literal("add-custom-resource"),payload:K.object({resource_id:W,parent_component_id:W,skipped:K.boolean().optional()})}),K.object({type:K.literal("move-item-before"),payload:K.object({target:I,reference_id:W})}),K.object({type:K.literal("move-item-after"),payload:K.object({target:I,reference_id:W})}),K.object({type:K.literal("move-item-to-start"),payload:K.object({target:I})}),K.object({type:K.literal("move-item-to-end"),payload:K.object({target:I})}),K.object({type:K.literal("change-item-parent"),payload:K.object({target:I,new_parent_id:W,position:K.enum(["start","end"]).optional()})})]),VJ=K.object({operation:K.array(iZ),reason:W.optional()}),xJ=K.object({studentId:W,componentResourceId:W,result:K.object({status:K.enum(["active","tobedeleted"]),metadata:K.record(K.string(),K.unknown()).optional(),score:K.number().optional(),textScore:W.optional(),scoreDate:W,scorePercentile:K.number().optional(),scoreStatus:l,comment:W.optional(),learningObjectiveSet:K.array(K.object({source:W,learningObjectiveResults:K.array(K.object({learningObjectiveId:W,score:K.number().optional(),textScore:W.optional()}))})).optional(),inProgress:W.optional(),incomplete:W.optional(),late:W.optional(),missing:W.optional()})}),FJ=K.object({student:W,lesson:W,applicationName:W.optional(),testId:W.optional(),skipCourseEnrollment:K.boolean().optional()}),LJ=K.object({student:W,subject:L}),UJ=K.object({student:W,lesson:W}),jJ=K.object({userId:W}),PJ=K.object({userId:W,subject:K.enum(["Math","Reading","Language","Science"])}),GJ=K.object({student:W,subject:L,grade:F,testName:W.optional()}),BJ=K.object({testName:W}),nZ=K.object({student:W,subject:L,grade:F,testName:W.optional()}),AJ=K.object({items:K.array(nZ)}),hJ=K.object({spreadsheetUrl:K.url(),sheet:W}),OJ=K.object({student:W,status:K.enum(["assigned","in_progress","completed","failed","expired","cancelled"]).optional(),subject:W.optional(),grade:F.optional(),limit:K.number().int().positive().max(3000).optional(),offset:K.number().int().nonnegative().optional()}),vJ=K.object({student:W.optional(),status:K.enum(["assigned","in_progress","completed","failed","expired","cancelled"]).optional(),subject:W.optional(),grade:F.optional(),limit:K.number().int().positive().max(3000).optional(),offset:K.number().int().nonnegative().optional()}),IJ=K.object({student:W,question:W,response:K.union([W,K.array(W)]).optional(),responses:K.record(K.string(),K.union([W,K.array(W)])).optional(),lesson:W}),CJ=K.object({student:W,lesson:W,attempt:K.number().int().positive().optional()}),kJ=K.object({student:W,lesson:W}),DJ=K.object({student:W,lesson:W}),QJ=K.object({student:W,lesson:W.optional(),finalized:K.boolean().optional(),toolProvider:W.optional(),attempt:K.number().int().positive().optional()}),MJ=K.object({student:W,lesson:W,applicationName:W.optional()}),fJ=K.object({student:W,subject:L}),bJ=K.object({status:K.enum(["active","tobedeleted"]).optional()});import{z as Z}from"zod/v4";var JZ=Z.enum(["choice","text-entry","extended-text","inline-choice","match","order","associate","select-point","graphic-order","graphic-associate","graphic-gap-match","hotspot","hottext","slider","drawing","media","upload"]),M=Z.enum(["single","multiple","ordered","record"]),f=Z.enum(["identifier","boolean","integer","float","string","point","pair","directedPair","duration","file","uri"]),eZ=Z.enum(["easy","medium","hard"]),zZ=Z.enum(["linear","nonlinear"]),tZ=Z.enum(["individual","simultaneous"]),b=Z.enum(["show","hide"]),KZ=Z.enum(["test","item","stimulus"]),uJ=Z.enum(["QUESTION","LESSON"]),Zq=Z.object({value:Z.array(Z.string())}).strict(),WZ=Z.object({identifier:Z.string().min(1),cardinality:M,baseType:f.optional(),correctResponse:Zq}).strict(),XZ=Z.object({identifier:Z.string().min(1),cardinality:M,baseType:f.optional()}).strict(),YZ=Z.object({identifier:Z.string().min(1),cardinality:M.optional(),baseType:f,normalMaximum:Z.number().optional(),normalMinimum:Z.number().optional(),defaultValue:Z.object({value:Z.unknown().optional()}).strict().optional()}).strict(),qq=Z.object({outcomeIdentifier:Z.string().min(1),variableIdentifier:Z.string().min(1)}).strict(),_Z=Z.object({templateType:Z.enum(["match_correct","map_response"]),responseDeclarationIdentifier:Z.string().min(1),outcomeIdentifier:Z.string().min(1),correctResponseIdentifier:Z.string().min(1),incorrectResponseIdentifier:Z.string().min(1),inlineFeedback:qq.optional()}).strict(),Jq=Z.object({source:Z.string().min(1),learningObjectiveIds:Z.array(Z.string())}).strict(),$Z=Z.object({subject:Z.string().optional(),grade:F.optional(),difficulty:eZ.optional(),learningObjectiveSet:Z.array(Jq).optional()}).strict(),HZ=Z.object({outcomeIdentifier:Z.string().min(1),identifier:Z.string().min(1),showHide:b,content:Z.string(),title:Z.string()}).strict(),wZ=Z.object({outcomeIdentifier:Z.string().min(1),identifier:Z.string().min(1),showHide:b,content:Z.string(),class:Z.array(Z.string())}).strict(),VZ=Z.object({outcomeIdentifier:Z.string().min(1),identifier:Z.string().min(1),showHide:b,content:Z.string(),class:Z.array(Z.string())}).strict(),xZ=Z.object({href:Z.string().min(1),type:Z.string().min(1)}).strict(),FZ=Z.object({id:Z.string().min(1),support:Z.string(),content:Z.string()}).strict(),dJ=Z.object({page:Z.number().int().positive().optional(),limit:Z.number().int().positive().optional(),sort:Z.string().optional(),order:Z.enum(["asc","desc"]).optional()}).strict(),NJ=Z.object({identifier:Z.string().min(1),title:Z.string().min(1),type:JZ,qtiVersion:Z.string().optional(),timeDependent:Z.boolean().optional(),adaptive:Z.boolean().optional(),responseDeclarations:Z.array(WZ).optional(),outcomeDeclarations:Z.array(XZ).optional(),responseProcessing:_Z.optional(),metadata:$Z.optional(),modalFeedback:Z.array(HZ).optional(),feedbackInline:Z.array(wZ).optional(),feedbackBlock:Z.array(VZ).optional()}).strict(),cJ=Z.object({identifier:Z.string().min(1).optional(),title:Z.string().min(1),type:JZ,qtiVersion:Z.string().optional(),timeDependent:Z.boolean().optional(),adaptive:Z.boolean().optional(),responseDeclarations:Z.array(WZ).optional(),outcomeDeclarations:Z.array(XZ).optional(),responseProcessing:_Z.optional(),metadata:$Z.optional(),modalFeedback:Z.array(HZ).optional(),feedbackInline:Z.array(wZ).optional(),feedbackBlock:Z.array(VZ).optional(),rawXml:Z.string(),content:Z.record(Z.string(),Z.unknown())}).strict(),pJ=Z.object({response:Z.union([Z.string(),Z.array(Z.string())])}).strict(),LZ=Z.object({identifier:Z.string().min(1),href:Z.union([Z.string(),Z.array(Z.string()),Z.array(Z.array(Z.string()))]).optional(),sequence:Z.number().optional()}).strict(),qZ=Z.object({identifier:Z.string().min(1),title:Z.string().min(1),visible:Z.boolean(),required:Z.boolean().optional(),fixed:Z.boolean().optional(),sequence:Z.number().optional(),"qti-assessment-item-ref":Z.array(LZ).optional()}).strict(),UZ=Z.object({identifier:Z.string().min(1),navigationMode:zZ,submissionMode:tZ,"qti-assessment-section":Z.union([qZ,Z.array(qZ)])}).strict(),EJ=Z.object({items:Z.array(LZ).min(1)}).strict(),yJ=Z.object({metadata:Z.record(Z.string(),Z.unknown()).optional()}).strict(),sJ=Z.object({identifier:Z.string().min(1),title:Z.string().min(1),qtiVersion:Z.string().optional(),toolName:Z.string().optional(),toolVersion:Z.string().optional(),timeLimit:Z.number().optional(),maxAttempts:Z.number().optional(),toolsEnabled:Z.record(Z.string(),Z.boolean()).optional(),metadata:Z.record(Z.string(),Z.unknown()).optional(),"qti-test-part":UZ,"qti-outcome-declaration":Z.array(YZ).optional()}).strict(),gJ=Z.object({identifier:Z.string().min(1).optional(),title:Z.string().min(1),qtiVersion:Z.string().optional(),toolName:Z.string().optional(),toolVersion:Z.string().optional(),timeLimit:Z.number().optional(),maxAttempts:Z.number().optional(),toolsEnabled:Z.record(Z.string(),Z.boolean()).optional(),metadata:Z.record(Z.string(),Z.unknown()).optional(),"qti-test-part":UZ,"qti-outcome-declaration":Z.array(YZ).optional()}).strict(),mJ=Z.object({identifier:Z.string().min(1),title:Z.string().min(1),label:Z.string().optional(),language:Z.string().optional(),stylesheet:xZ.optional(),content:Z.string(),catalogInfo:Z.array(FZ).optional(),toolName:Z.string().optional(),toolVersion:Z.string().optional(),metadata:Z.record(Z.string(),Z.unknown()).optional()}).strict(),SJ=Z.object({identifier:Z.string().min(1).optional(),title:Z.string().min(1),label:Z.string().optional(),language:Z.string().optional(),stylesheet:xZ.optional(),content:Z.string(),catalogInfo:Z.array(FZ).optional(),toolName:Z.string().optional(),toolVersion:Z.string().optional(),metadata:Z.record(Z.string(),Z.unknown()).optional()}).strict(),oJ=Z.object({xml:Z.string().optional(),schema:KZ,entityId:Z.string().optional()}).strict(),rJ=Z.object({xml:Z.array(Z.string()),schema:KZ,entityIds:Z.array(Z.string())}).strict(),aJ=Z.object({questionId:Z.string().optional(),userId:Z.string().min(1),feedback:Z.string().min(1),lessonId:Z.string().min(1),humanApproved:Z.boolean().optional()}).strict();export{L as a,F as b,Hq as c};

package/dist/{chunk-9se82640.js → chunk-txwjkpfz.js}

@@ -1 +1 @@
-function k(x,I){let E=I?.batchSize??50;if(E<=0)return[x.slice()];let R=[];for(let $=0;$<x.length;$+=E)R.push(x.slice($,$+E));return R}function q(x){return x.filter((I)=>I.status==="fulfilled").flatMap((I)=>I.value)}function C(...x){return x.map((E)=>E?.trim()).filter((E)=>Boolean(E)).join(" ")||void 0}function D(x){let I=x.lastIndexOf("@");if(I<=0)return"<redacted>";let E=x.slice(0,I),R=x.slice(I+1);return`${E.slice(0,1)}***@${R}`}export{C as t,D as u,k as v,q as w};
+function k(x,I){let E=I?.batchSize??50;if(E<=0)return[x.slice()];let R=[];for(let $=0;$<x.length;$+=E)R.push(x.slice($,$+E));return R}function q(x){return x.filter((I)=>I.status==="fulfilled").flatMap((I)=>I.value)}function C(...x){return x.map((E)=>E?.trim()).filter((E)=>Boolean(E)).join(" ")||void 0}function D(x){let I=x.lastIndexOf("@");if(I<=0)return"<redacted>";let E=x.slice(0,I),R=x.slice(I+1);return`${E.slice(0,1)}***@${R}`}export{C as x,D as y,k as z,q as A};

package/dist/client/adapters/react/hooks/types.d.ts

@@ -1,32 +1,39 @@
-import type { TimebackProfile } from '../../../../shared/types';
+import type { TimebackProfileState } from '../../../../shared/types';
+export type { TimebackProfileState, TimebackVerificationState } from '../../../../shared/types';
 /**
- * Verification state for the current user.
+ * Options for useTimebackVerification hook.
  */
-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;
-};
+export interface UseTimebackVerificationOptions {
+    /**
+     * If false, the hook 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[];
+}
 /**
  * Options for the useTimebackProfile hook.
  */

package/dist/client/adapters/react/hooks/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/client/adapters/react/hooks/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE/D;;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,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,4BAA4B;IAC5B,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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/client/adapters/react/hooks/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAEpE,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AAE/F;;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,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,4BAA4B;IAC5B,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/react/hooks/useTimebackVerification.d.ts

@@ -1,17 +1,29 @@
-import type { TimebackVerificationState } from './types';
+import type { TimebackVerificationState, UseTimebackVerificationOptions } from './types';
 /**
  * Verify the current user against Timeback.
  *
  * The hook runs automatically once the Timeback client is available, and
  * provides a `refresh()` method to retry.
  *
+ * By default, the hook retries failed verification attempts with exponential
+ * backoff to handle race conditions (e.g., user not yet created in backend).
+ *
  * @param options - Hook options
- * @param options.enabled - If false, the hook does nothing and stays in loading state.
  * @returns Verification state and a refresh method
+ *
+ * @example
+ * ```tsx
+ * // Default: auto-verify with retry on mount
+ * const { state } = useTimebackVerification()
+ *
+ * // Delay verification until user exists
+ * const { state } = useTimebackVerification({ enabled: !!user })
+ *
+ * // Disable retries
+ * const { state } = useTimebackVerification({ retryAttempts: 0 })
+ * ```
  */
-export declare function useTimebackVerification(options?: {
-    enabled?: boolean;
-}): {
+export declare function useTimebackVerification(options?: UseTimebackVerificationOptions): {
     state: TimebackVerificationState;
     refresh: () => void;
 };

package/dist/client/adapters/react/hooks/useTimebackVerification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTimebackVerification.d.ts","sourceRoot":"","sources":["../../../../../src/client/adapters/react/hooks/useTimebackVerification.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAsFxD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG;IAC7E,KAAK,EAAE,yBAAyB,CAAA;IAChC,OAAO,EAAE,MAAM,IAAI,CAAA;CACnB,CA6DA"}
+{"version":3,"file":"useTimebackVerification.d.ts","sourceRoot":"","sources":["../../../../../src/client/adapters/react/hooks/useTimebackVerification.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,SAAS,CAAA;AAcxF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,8BAAmC,GAAG;IACtF,KAAK,EAAE,yBAAyB,CAAA;IAChC,OAAO,EAAE,MAAM,IAAI,CAAA;CACnB,CAiGA"}

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

@@ -42,7 +42,7 @@ export { Activity } from '../../lib/activity';
 export { TimebackProvider, useTimeback } from './provider';
 export { useTimebackVerification } from './hooks/useTimebackVerification';
 export { useTimebackProfile } from './hooks/useTimebackProfile';
-export type { TimebackProfileState, TimebackVerificationState, UseTimebackProfileOptions, UseTimebackProfileResult, } from './hooks/types';
+export type { TimebackProfileState, TimebackVerificationState, UseTimebackProfileOptions, UseTimebackProfileResult, UseTimebackVerificationOptions, } from './hooks/types';
 export { SignInButton } from './SignInButton';
 export type { SignInButtonProps } from './SignInButton';
 export type { TimebackIdentity, ActivityParams, ActivityMetrics } from '../../../shared/types';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAG5D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAG7C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC/D,YAAY,EACX,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,GACxB,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGvD,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAG5D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAG7C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC/D,YAAY,EACX,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,GAC9B,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGvD,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/client/adapters/react/index.js

@@ -1,4 +1,4 @@
-import{a as AA,b as I,c as KA}from"../../../chunk-ahy54f2r.js";import*as B from"react";import{jsx as l}from"react/jsx-runtime";var g=B.createContext(void 0),S;function h(){if(!S)S=new I;return S}function o({client:A,children:M}){let[U,K]=B.useState(A);return B.useEffect(()=>{if(!U)K(A??h())},[U,A]),l(g.Provider,{value:U,children:M})}function V(){return B.useContext(g)}import*as z from"react";var r=1500,H=new WeakMap,N=new WeakMap;function m(A){return!!A&&Date.now()-A.atMs<r}function k(A){return A.verified?{status:"verified",timebackId:A.timebackId}:{status:"unverified"}}async function s(A,M){if(!M){let K=N.get(A);if(m(K))return K.result;let q=H.get(A);if(q)return await q}let U=A.user.verify().then((K)=>{if(H.get(A)===U)N.set(A,{atMs:Date.now(),result:K});return K});H.set(A,U);try{return await U}finally{if(H.get(A)===U)H.delete(A)}}function F(A={}){let M=V(),U=A.enabled??!0,[K,q]=z.useState({status:"loading"}),[_,D]=z.useState(0),G=z.useRef(0),E=z.useCallback(()=>{D((Q)=>Q+1)},[]);return z.useEffect(()=>{if(!U)return;let Q=!1,X=_>G.current;if(M&&!X){let J=N.get(M);if(m(J))return q(k(J.result)),()=>{Q=!0}}return q({status:"loading"}),(async()=>{try{if(!M)return;if(X)G.current=_;let J=await s(M,X);if(Q)return;q(k(J))}catch(J){if(!Q)q({status:"error",message:J instanceof Error?J.message:"Failed to verify Timeback user"})}})(),()=>{Q=!0}},[U,_,M]),{state:K,refresh:E}}import*as $ from"react";var P=new WeakMap,C=new WeakMap;function u(A){return!!A&&Date.now()-A.atMs<5000}async function b(A,M){if(!M){let K=C.get(A);if(u(K))return K.profile;let q=P.get(A);if(q)return await q}let U=A.user.fetch().then((K)=>{if(P.get(A)===U)C.set(A,{atMs:Date.now(),profile:K});return K});P.set(A,U);try{return await U}finally{if(P.get(A)===U)P.delete(A)}}function v(A){let M=C.get(A);return u(M)?M.profile:void 0}function n(A={}){let{enabled:M=!0,auto:U=!1}=A,K=V(),{state:q}=F({enabled:M}),[_,D]=$.useState({status:"idle"}),[G,E]=$.useState(0),[Q,X]=$.useState(0),J=$.useRef(0),L=$.useRef(0),O=M&&q.status==="verified"&&!!K,j=$.useCallback(()=>{if(!O)return;E((Y)=>Y+1)},[O]),x=$.useCallback(()=>{if(!O)return;X((Y)=>Y+1)},[O]),w=$.useRef(!1);return $.useEffect(()=>{if(!M){D({status:"idle"});return}if(q.status!=="verified"){D((Z)=>Z.status==="idle"?Z:{status:"idle"}),w.current=!1;return}if(U&&!w.current&&G===0){w.current=!0,E(1);return}if(G===0&&Q===0)return;let Y=!1,f=G>J.current,y=Q>L.current,p=y;if(!f&&!y){if(K){let Z=v(K);if(Z)return D({status:"loaded",profile:Z}),()=>{Y=!0}}return}if(K&&!p){let Z=v(K);if(Z)return D({status:"loaded",profile:Z}),J.current=G,()=>{Y=!0}}return D({status:"loading"}),(async()=>{try{if(!K)return;J.current=G,L.current=Q;let Z=await b(K,p);if(Y)return;D({status:"loaded",profile:Z})}catch(Z){if(!Y)D({status:"error",message:Z instanceof Error?Z.message:"Failed to fetch profile"})}})(),()=>{Y=!0}},[M,q.status,G,Q,K,U]),{state:_,canFetch:O,fetchProfile:j,refresh:x}}import*as R from"react";import{jsx as W,jsxs as T}from"react/jsx-runtime";function c({className:A}){return T("svg",{className:A,width:"20",height:"18",viewBox:"0 0 199 180",fill:"none",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",children:[T("g",{clipPath:"url(#tb-logo-clip)",children:[W("path",{d:"M121.432 179.456C110.607 177.871 101.153 173.91 92.4882 168.085C91.1274 167.17 89.4598 165.404 89.4375 164.008C89.2123 149.891 89.3002 135.77 89.3002 119.86C93.1365 123.255 95.8538 125.706 98.6224 128.099C103.151 132.012 107.437 136.28 112.314 139.703C126.466 149.635 145.037 147.25 156.045 134.448C166.919 121.803 167.226 101.374 155.695 89.6399C145.727 79.4958 134.693 70.3995 123.251 60.0438C123.251 77.8871 123.251 94.5637 123.251 112.15C121.428 110.999 120.279 110.479 119.383 109.676C110.329 101.573 101.241 93.5044 92.3634 85.2109C90.8519 83.7988 89.4363 81.3758 89.4209 79.4084C89.2249 54.4218 89.2905 29.4332 89.3061 4.44502C89.3066 3.64954 89.3061 2.22136 89.3061 1.47755C90.8061 1.47755 92.694 1.47857 94.1427 1.47755C118.131 1.46071 142.12 1.52088 166.108 1.39821C169.235 1.38222 171.33 2.18661 173.251 4.75826C180.607 14.6032 188.189 24.279 196.266 34.7705C179.79 34.7705 164.169 34.7705 148.548 34.7705C147.871 34.7705 147.366 34.7705 146.866 34.7705C147.866 35.7705 150.35 38.3018 151.61 39.4825C162.643 49.8249 174.663 59.3807 184.245 70.947C202.474 92.9508 203.539 118.134 191.204 143.046C178.598 168.508 156.61 180.302 128.298 180.295C126.154 180.295 124.011 179.778 121.432 179.456Z",fill:"currentColor"}),W("circle",{cx:"40",cy:"133",r:"39",fill:"currentColor"}),W("circle",{cx:"39",cy:"39",r:"39",fill:"currentColor"})]}),W("defs",{children:W("clipPath",{id:"tb-logo-clip",children:W("rect",{width:"199",height:"180",fill:"currentColor"})})})]})}function a({className:A}){return T("svg",{className:A,width:"16",height:"16",viewBox:"0 0 24 24",fill:"none",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",children:[W("circle",{cx:"12",cy:"12",r:"10",stroke:"currentColor",strokeWidth:"2",strokeOpacity:"0.25"}),W("path",{d:"M12 2C6.48 2 2 6.48 2 12",stroke:"currentColor",strokeWidth:"2",strokeLinecap:"round"})]})}var i=`
+import{a as h,b as o,c as l,d as r,e as QK,f as S,g as UK}from"../../../chunk-92nnwa7t.js";import*as D from"react";import{jsx as a}from"react/jsx-runtime";var p=D.createContext(void 0),R;function c(){if(!R)R=new S;return R}function i({client:K,children:J}){let[M,q]=D.useState(void 0);D.useEffect(()=>{if(!K&&!M)q(c())},[K,M]);let Q=K??M;return a(p.Provider,{value:Q,children:J})}function w(){return D.useContext(p)}import*as _ from"react";var T=new WeakMap,F=new WeakMap,j=new WeakMap,N=new WeakMap;function k(K){return!!K&&Date.now()-K.atMs<1500}function m(K){return!!K&&Date.now()-K.atMs<5000}async function b(K,J){if(!J){let q=F.get(K);if(k(q))return q.result;let Q=T.get(K);if(Q)return await Q}let M=K.user.verify().then((q)=>{if(T.get(K)===M)F.set(K,{atMs:Date.now(),result:q});return q});T.set(K,M);try{return await M}finally{if(T.get(K)===M)T.delete(K)}}function u(K){let J=F.get(K);return k(J)?J.result:void 0}async function d(K,J){if(!J){let q=N.get(K);if(m(q))return q.profile;let Q=j.get(K);if(Q)return await Q}let M=K.user.fetch().then((q)=>{if(j.get(K)===M)N.set(K,{atMs:Date.now(),profile:q});return q});j.set(K,M);try{return await M}finally{if(j.get(K)===M)j.delete(K)}}function v(K){let J=N.get(K);return m(J)?J.profile:void 0}function f(K){return K.verified?{status:"verified",timebackId:K.timebackId}:{status:"unverified"}}function C(K={}){let J=w(),M=K.enabled??!0,q=K.retryAttempts??h,Q=K.retryDelays??o,[L,Z]=_.useState({status:"loading"}),[G,H]=_.useState(0),V=_.useRef(0),E=_.useCallback(()=>{H((U)=>U+1)},[]);return _.useEffect(()=>{if(!M)return;let U=!1,A=G>V.current;if(J&&!A){let $=u(J);if($)return Z(f($)),()=>{U=!0}}return Z({status:"loading"}),(async()=>{if(!J)return;if(A)V.current=G;let $;for(let Y=0;Y<=q;Y++){if(U)return;if(Y>0){let X=r(Q,Y-1);if(await l(X),U)return}try{let X=await b(J,A||Y>0);if(U)return;Z(f(X));return}catch(X){$=X instanceof Error?X:Error("Failed to verify Timeback user")}}if(!U&&$)Z({status:"error",message:$.message})})(),()=>{U=!0}},[M,G,q,Q,J]),{state:L,refresh:E}}import*as z from"react";function t(K={}){let{enabled:J=!0,auto:M=!1}=K,q=w(),{state:Q}=C({enabled:J}),[L,Z]=z.useState({status:"idle"}),[G,H]=z.useState(0),[V,E]=z.useState(0),U=z.useRef(0),A=z.useRef(0),$=J&&Q.status==="verified"&&!!q,Y=z.useCallback(()=>{if(!$)return;H((O)=>O+1)},[$]),X=z.useCallback(()=>{if(!$)return;E((O)=>O+1)},[$]),P=z.useRef(!1);return z.useEffect(()=>{if(!J){Z({status:"idle"});return}if(Q.status!=="verified"){Z((W)=>W.status==="idle"?W:{status:"idle"}),P.current=!1;return}if(M&&!P.current&&G===0){P.current=!0,H(1);return}if(G===0&&V===0)return;let O=!1,n=G>U.current,y=V>A.current,g=y;if(!n&&!y){if(q){let W=v(q);if(W)return Z({status:"loaded",profile:W}),()=>{O=!0}}return}if(q&&!g){let W=v(q);if(W)return Z({status:"loaded",profile:W}),U.current=G,()=>{O=!0}}return Z({status:"loading"}),(async()=>{try{if(!q)return;U.current=G,A.current=V;let W=await d(q,g);if(O)return;Z({status:"loaded",profile:W})}catch(W){if(!O)Z({status:"error",message:W instanceof Error?W.message:"Failed to fetch profile"})}})(),()=>{O=!0}},[J,Q.status,G,V,q,M]),{state:L,canFetch:$,fetchProfile:Y,refresh:X}}import*as I from"react";import{jsx as B,jsxs as x}from"react/jsx-runtime";function e({className:K}){return x("svg",{className:K,width:"20",height:"18",viewBox:"0 0 199 180",fill:"none",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",children:[x("g",{clipPath:"url(#tb-logo-clip)",children:[B("path",{d:"M121.432 179.456C110.607 177.871 101.153 173.91 92.4882 168.085C91.1274 167.17 89.4598 165.404 89.4375 164.008C89.2123 149.891 89.3002 135.77 89.3002 119.86C93.1365 123.255 95.8538 125.706 98.6224 128.099C103.151 132.012 107.437 136.28 112.314 139.703C126.466 149.635 145.037 147.25 156.045 134.448C166.919 121.803 167.226 101.374 155.695 89.6399C145.727 79.4958 134.693 70.3995 123.251 60.0438C123.251 77.8871 123.251 94.5637 123.251 112.15C121.428 110.999 120.279 110.479 119.383 109.676C110.329 101.573 101.241 93.5044 92.3634 85.2109C90.8519 83.7988 89.4363 81.3758 89.4209 79.4084C89.2249 54.4218 89.2905 29.4332 89.3061 4.44502C89.3066 3.64954 89.3061 2.22136 89.3061 1.47755C90.8061 1.47755 92.694 1.47857 94.1427 1.47755C118.131 1.46071 142.12 1.52088 166.108 1.39821C169.235 1.38222 171.33 2.18661 173.251 4.75826C180.607 14.6032 188.189 24.279 196.266 34.7705C179.79 34.7705 164.169 34.7705 148.548 34.7705C147.871 34.7705 147.366 34.7705 146.866 34.7705C147.866 35.7705 150.35 38.3018 151.61 39.4825C162.643 49.8249 174.663 59.3807 184.245 70.947C202.474 92.9508 203.539 118.134 191.204 143.046C178.598 168.508 156.61 180.302 128.298 180.295C126.154 180.295 124.011 179.778 121.432 179.456Z",fill:"currentColor"}),B("circle",{cx:"40",cy:"133",r:"39",fill:"currentColor"}),B("circle",{cx:"39",cy:"39",r:"39",fill:"currentColor"})]}),B("defs",{children:B("clipPath",{id:"tb-logo-clip",children:B("rect",{width:"199",height:"180",fill:"currentColor"})})})]})}function KK({className:K}){return x("svg",{className:K,width:"16",height:"16",viewBox:"0 0 24 24",fill:"none",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",children:[B("circle",{cx:"12",cy:"12",r:"10",stroke:"currentColor",strokeWidth:"2",strokeOpacity:"0.25"}),B("path",{d:"M12 2C6.48 2 2 6.48 2 12",stroke:"currentColor",strokeWidth:"2",strokeLinecap:"round"})]})}var qK=`
 .timeback-signin-btn {
   /* Colors */
   --tb-btn-bg: #0f172a;
@@ -110,4 +110,4 @@ import{a as AA,b as I,c as KA}from"../../../chunk-ahy54f2r.js";import*as B from"
   from { transform: rotate(0deg); }
   to { transform: rotate(360deg); }
 }
-`,d=!1;function t(){if(typeof document>"u"||d)return;let A=document.createElement("style");A.setAttribute("data-timeback-styles",""),A.textContent=i,document.head.appendChild(A),d=!0}function e(A){let{children:M="Sign in with Timeback",className:U,style:K,disabled:q,showLoading:_=!0,onClick:D,variant:G="default",size:E="md",showLogo:Q=!0}=A,X=V(),[J,L]=R.useState(!1),O=!!X;R.useEffect(()=>{t()},[]);let j=(w)=>{if(D){if(D(w),w.defaultPrevented)return}if(_)L(!0);X?.auth.signIn()},x=["timeback-signin-btn",G!=="default"&&`timeback-signin-btn--${G}`,E!=="md"&&`timeback-signin-btn--${E}`,U].filter(Boolean).join(" ");return T("button",{type:"button",className:x,style:K,disabled:q||!O||J,onClick:j,"aria-busy":J,children:[J?W(a,{className:"timeback-signin-btn__spinner"}):Q?W(c,{className:"timeback-signin-btn__logo"}):null,M]})}export{F as useTimebackVerification,n as useTimebackProfile,V as useTimeback,KA as createClient,o as TimebackProvider,I as TimebackClient,e as SignInButton,AA as Activity};
+`,s=!1;function JK(){if(typeof document>"u"||s)return;let K=document.createElement("style");K.setAttribute("data-timeback-styles",""),K.textContent=qK,document.head.appendChild(K),s=!0}function MK(K){let{children:J="Sign in with Timeback",className:M,style:q,disabled:Q,showLoading:L=!0,onClick:Z,variant:G="default",size:H="md",showLogo:V=!0}=K,E=w(),[U,A]=I.useState(!1),$=!!E;I.useEffect(()=>{JK()},[]);let Y=(P)=>{if(Z){if(Z(P),P.defaultPrevented)return}if(L)A(!0);E?.auth.signIn()},X=["timeback-signin-btn",G!=="default"&&`timeback-signin-btn--${G}`,H!=="md"&&`timeback-signin-btn--${H}`,M].filter(Boolean).join(" ");return x("button",{type:"button",className:X,style:q,disabled:Q||!$||U,onClick:Y,"aria-busy":U,children:[U?B(KK,{className:"timeback-signin-btn__spinner"}):V?B(e,{className:"timeback-signin-btn__logo"}):null,J]})}export{C as useTimebackVerification,t as useTimebackProfile,w as useTimeback,UK as createClient,i as TimebackProvider,S as TimebackClient,MK as SignInButton,QK as Activity};

package/dist/client/adapters/react/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/react/provider.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAO5D;;GAEG;AACH,UAAU,qBAAqB;IAC9B,wFAAwF;IACxF,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,uBAAuB;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CACzB;AAiBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,EAChC,MAAM,EAAE,cAAc,EACtB,QAAQ,EACR,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CAU5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,WAAW,IAAI,cAAc,GAAG,SAAS,CAExD"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/react/provider.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAO5D;;GAEG;AACH,UAAU,qBAAqB;IAC9B,wFAAwF;IACxF,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,uBAAuB;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CACzB;AAiBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,EAChC,MAAM,EAAE,cAAc,EACtB,QAAQ,EACR,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CAiC5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,WAAW,IAAI,cAAc,GAAG,SAAS,CAExD"}

package/dist/client/adapters/solid/primitives/createTimebackVerification.d.ts

@@ -13,8 +13,10 @@ import type { CreateTimebackVerificationOptions, CreateTimebackVerificationResul
  * Runs automatically once the Timeback client is available, and
  * provides a `refresh()` method to retry.
  *
+ * By default, retries failed verification attempts with exponential
+ * backoff to handle race conditions (e.g., user not yet created in backend).
+ *
  * @param options - Options
- * @param options.enabled - If false, does nothing and stays in loading state.
  * @returns Verification state and a refresh method
  *
  * @example

package/dist/client/adapters/solid/primitives/createTimebackVerification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createTimebackVerification.d.ts","sourceRoot":"","sources":["../../../../../src/client/adapters/solid/primitives/createTimebackVerification.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EACX,iCAAiC,EACjC,gCAAgC,EAEhC,MAAM,UAAU,CAAA;AAcjB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,0BAA0B,CACzC,OAAO,GAAE,iCAAsC,GAC7C,gCAAgC,CAwElC"}
+{"version":3,"file":"createTimebackVerification.d.ts","sourceRoot":"","sources":["../../../../../src/client/adapters/solid/primitives/createTimebackVerification.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,KAAK,EACX,iCAAiC,EACjC,gCAAgC,EAEhC,MAAM,UAAU,CAAA;AAcjB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,0BAA0B,CACzC,OAAO,GAAE,iCAAsC,GAC7C,gCAAgC,CA4GlC"}

package/dist/client/adapters/solid/primitives/createTimebackVerification.ts

@@ -9,7 +9,9 @@
 
 import { createEffect, createSignal, onCleanup } from 'solid-js'
 
+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 '../context'
 
 import type { TimebackVerifyResult } from '../../../../shared/types'
@@ -37,8 +39,10 @@ function toState(result: TimebackVerifyResult): TimebackVerificationState {
  * Runs automatically once the Timeback client is available, and
  * provides a `refresh()` method to retry.
  *
+ * By default, retries failed verification attempts with exponential
+ * backoff to handle race conditions (e.g., user not yet created in backend).
+ *
  * @param options - Options
- * @param options.enabled - If false, does nothing and stays in loading state.
  * @returns Verification state and a refresh method
  *
  * @example
@@ -60,6 +64,8 @@ export function createTimebackVerification(
 	options: CreateTimebackVerificationOptions = {},
 ): CreateTimebackVerificationResult {
 	const enabled = options.enabled ?? true
+	const retryAttempts = options.retryAttempts ?? DEFAULT_RETRY_ATTEMPTS
+	const retryDelays = options.retryDelays ?? DEFAULT_RETRY_DELAYS_MS
 	const timeback = useTimeback()
 
 	const [state, setState] = createSignal<TimebackVerificationState>({ status: 'loading' })
@@ -96,26 +102,60 @@ export function createTimebackVerification(
 		setState({ status: 'loading' })
 
 		void (async () => {
-			try {
-				if (!client) return
+			if (!client) return
 
-				if (force) {
-					lastHandledRefreshNonce = nonce
-				}
+			if (force) {
+				lastHandledRefreshNonce = nonce
+			}
 
-				const result = await verifyOnce(client, force)
+			let lastError: Error | undefined
 
+			for (let attempt = 0; attempt <= retryAttempts; attempt++) {
 				if (cancelled) return
 
-				setState(toState(result))
-			} catch (err) {
-				if (!cancelled) {
-					setState({
-						status: 'error',
-						message:
-							err instanceof Error ? err.message : 'Failed to verify Timeback user',
-					})
+				/**
+				 * 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(client, force || attempt > 0)
+
+					if (cancelled) return
+
+					setState(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) {
+				setState({
+					status: 'error',
+					message: lastError.message,
+				})
 			}
 		})()
 

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

@@ -3,35 +3,8 @@
  *
  * Types for Solid-specific primitives.
  */
-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;
-};
+import type { TimebackProfileState, TimebackVerificationState } from '../../../shared/types';
+export type { TimebackProfileState, TimebackVerificationState } from '../../../shared/types';
 /**
  * Options for createTimebackVerification.
  */
@@ -39,9 +12,32 @@ export interface CreateTimebackVerificationOptions {
     /**
      * If false, 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 createTimebackVerification.

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/solid/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,iCAAiC;IACjD;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAChD,iCAAiC;IACjC,KAAK,EAAE,yBAAyB,CAAA;IAEhC,qDAAqD;IACrD,OAAO,EAAE,MAAM,IAAI,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC5C;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C,4BAA4B;IAC5B,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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/solid/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAA;AAE5F,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAA;AAE5F;;GAEG;AACH,MAAM,WAAW,iCAAiC;IACjD;;;;;;;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,gCAAgC;IAChD,iCAAiC;IACjC,KAAK,EAAE,yBAAyB,CAAA;IAEhC,qDAAqD;IACrD,OAAO,EAAE,MAAM,IAAI,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC5C;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C,4BAA4B;IAC5B,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/solid/types.ts

@@ -4,25 +4,9 @@
  * Types for Solid-specific primitives.
  */
 
-import type { TimebackProfile } from '../../../shared/types'
+import type { TimebackProfileState, TimebackVerificationState } 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 }
+export type { TimebackProfileState, TimebackVerificationState } from '../../../shared/types'
 
 /**
  * Options for createTimebackVerification.
@@ -31,9 +15,34 @@ export interface CreateTimebackVerificationOptions {
 	/**
 	 * If false, 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[]
 }
 
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../src/client/adapters/svelte/stores/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAyB5C;;GAEG;AACH,eAAO,MAAM,WAAW,6DAAkD,CAAA;AAE1E;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAE9D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAQ1D;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,cAAc,GAAG,SAAS,CAAe,CAAA"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../src/client/adapters/svelte/stores/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAIrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAgB5C;;GAEG;AACH,eAAO,MAAM,WAAW,6DAAkD,CAAA;AAE1E;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAE9D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAQ1D;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,cAAc,GAAG,SAAS,CAAe,CAAA"}