@timeback/sdk 0.1.7 → 0.1.9

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

@@ -0,0 +1,110 @@
+/**
+ * Vue Types
+ *
+ * Types for Vue-specific composables.
+ */
+
+import type { TimebackProfile } from '../../../shared/types'
+
+/**
+ * Verification state for the current user.
+ */
+export type TimebackVerificationState =
+	| { status: 'loading' }
+	| { status: 'verified'; timebackId: string }
+	| { status: 'unverified' }
+	| { status: 'error'; message: string }
+
+/**
+ * Profile state for the current user.
+ */
+export type TimebackProfileState =
+	| { status: 'idle' }
+	| { status: 'loading' }
+	| { status: 'loaded'; profile: TimebackProfile }
+	| { status: 'error'; message: string }
+
+/**
+ * Options for the useTimebackVerification composable.
+ */
+export interface UseTimebackVerificationOptions {
+	/**
+	 * If false, the composable does nothing and stays in loading state.
+	 *
+	 * 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 the useTimebackVerification composable.
+ */
+export interface UseTimebackVerificationResult {
+	/** Current verification state (reactive ref) */
+	state: TimebackVerificationState
+
+	/** Force a re-verification. No-op if not enabled. */
+	refresh: () => void
+}
+
+/**
+ * Options for the useTimebackProfile composable.
+ */
+export interface UseTimebackProfileOptions {
+	/**
+	 * If false, the composable does nothing and stays in idle state.
+	 *
+	 * @default true
+	 */
+	enabled?: boolean
+
+	/**
+	 * If true, automatically fetch the profile once the user is verified.
+	 * If false, you must call `fetchProfile()` manually.
+	 *
+	 * @default false
+	 */
+	auto?: boolean
+}
+
+/**
+ * Return value of the useTimebackProfile composable.
+ */
+export interface UseTimebackProfileResult {
+	/** Current profile state (reactive ref) */
+	state: TimebackProfileState
+
+	/** Whether the profile can be fetched (user is verified and client is ready) */
+	canFetch: boolean
+
+	/** Manually trigger a profile fetch. No-op if canFetch is false. */
+	fetchProfile: () => void
+
+	/** Force a re-fetch even if already loaded. No-op if canFetch is false. */
+	refresh: () => void
+}

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,168 @@
+/**
+ * Shared User Cache
+ *
+ * Internal module for in-flight deduplication and short-lived caching of
+ * verify and profile requests. Used by Solid, Svelte, and Vue adapters.
+ */
+
+import type { TimebackProfile, TimebackVerifyResult } from '../../shared/types'
+import type { TimebackClient } from '../timeback-client.class'
+
+const VERIFY_CACHE_TTL_MS = 1500
+const PROFILE_CACHE_TTL_MS = 5000
+
+type VerifyCacheEntry = { atMs: number; result: TimebackVerifyResult }
+type ProfileCacheEntry = { atMs: number; profile: TimebackProfile }
+
+const verifyInFlight = new WeakMap<TimebackClient, Promise<TimebackVerifyResult>>()
+const verifyCache = new WeakMap<TimebackClient, VerifyCacheEntry>()
+
+const profileInFlight = new WeakMap<TimebackClient, Promise<TimebackProfile>>()
+const profileCache = new WeakMap<TimebackClient, ProfileCacheEntry>()
+
+/**
+ * Check whether a cached verification result is still fresh.
+ *
+ * @param entry - Cached entry (if any)
+ * @returns True if the cache entry exists and is within TTL
+ */
+function isVerifyCacheFresh(entry: VerifyCacheEntry | undefined): entry is VerifyCacheEntry {
+	return !!entry && Date.now() - entry.atMs < VERIFY_CACHE_TTL_MS
+}
+
+/**
+ * Check whether a cached profile result is still fresh.
+ *
+ * @param entry - Cached entry (if any)
+ * @returns True if the cache entry exists and is within TTL
+ */
+function isProfileCacheFresh(entry: ProfileCacheEntry | undefined): entry is ProfileCacheEntry {
+	return !!entry && Date.now() - entry.atMs < PROFILE_CACHE_TTL_MS
+}
+
+/**
+ * Verify the current user with in-flight dedupe and short-lived caching.
+ *
+ * @param timeback - Timeback client instance
+ * @param force - If true, bypass cache and in-flight reuse
+ * @returns Verify result
+ */
+export async function verifyOnce(
+	timeback: TimebackClient,
+	force: boolean,
+): Promise<TimebackVerifyResult> {
+	if (!force) {
+		const cached = verifyCache.get(timeback)
+
+		if (isVerifyCacheFresh(cached)) {
+			return cached.result
+		}
+
+		const existing = verifyInFlight.get(timeback)
+
+		if (existing) {
+			return await existing
+		}
+	}
+
+	const p = timeback.user.verify().then(result => {
+		/**
+		 * Guard against stale overwrites:
+		 *
+		 * If `force=true` triggers a newer request while an older one is still
+		 * in-flight, the older promise may resolve later. Only let the most
+		 * recent in-flight promise update the cache.
+		 */
+		if (verifyInFlight.get(timeback) === p) {
+			verifyCache.set(timeback, { atMs: Date.now(), result })
+		}
+		return result
+	})
+
+	verifyInFlight.set(timeback, p)
+	try {
+		return await p
+	} finally {
+		/**
+		 * Only remove the in-flight verification promise
+		 * if it is still the most recent for this client instance.
+		 */
+		if (verifyInFlight.get(timeback) === p) {
+			verifyInFlight.delete(timeback)
+		}
+	}
+}
+
+/**
+ * Get cached verification result if fresh.
+ *
+ * @param timeback - Timeback client instance
+ * @returns Cached result or undefined
+ */
+export function getVerifyCache(timeback: TimebackClient): TimebackVerifyResult | undefined {
+	const cached = verifyCache.get(timeback)
+	return isVerifyCacheFresh(cached) ? cached.result : undefined
+}
+
+/**
+ * Fetch the profile with in-flight dedupe and short-lived caching.
+ *
+ * @param timeback - Timeback client instance
+ * @param force - If true, bypass cache and in-flight reuse
+ * @returns The user's Timeback profile
+ */
+export async function fetchProfileOnce(
+	timeback: TimebackClient,
+	force: boolean,
+): Promise<TimebackProfile> {
+	if (!force) {
+		const cached = profileCache.get(timeback)
+
+		if (isProfileCacheFresh(cached)) {
+			return cached.profile
+		}
+
+		const existing = profileInFlight.get(timeback)
+
+		if (existing) {
+			return await existing
+		}
+	}
+
+	const p = timeback.user.fetch().then(profile => {
+		/**
+		 * Guard against stale overwrites:
+		 *
+		 * If `force=true` triggers a newer request while an older one is still
+		 * in-flight, the older promise may resolve later. Only let the most
+		 * recent in-flight promise update the cache.
+		 */
+		if (profileInFlight.get(timeback) === p) {
+			profileCache.set(timeback, { atMs: Date.now(), profile })
+		}
+		return profile
+	})
+
+	profileInFlight.set(timeback, p)
+	try {
+		return await p
+	} finally {
+		/**
+		 * Only remove the in-flight promise if it is still the most recent
+		 */
+		if (profileInFlight.get(timeback) === p) {
+			profileInFlight.delete(timeback)
+		}
+	}
+}
+
+/**
+ * Get cached profile result if fresh.
+ *
+ * @param timeback - Timeback client instance
+ * @returns Cached profile or undefined
+ */
+export function getProfileCache(timeback: TimebackClient): TimebackProfile | undefined {
+	const cached = profileCache.get(timeback)
+	return isProfileCacheFresh(cached) ? cached.profile : undefined
+}

package/dist/client/lib/utils.d.ts

@@ -17,4 +17,19 @@ export declare function isBrowser(): boolean;
  * @returns The default base URL or undefined during SSR
  */
 export declare function getDefaultBaseURL(): string | undefined;
+/**
+ * Sleep for a given number of milliseconds.
+ *
+ * @param ms - Duration to sleep in milliseconds
+ * @returns Promise that resolves after the delay
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Get retry delay for a given attempt from a delay configuration.
+ *
+ * @param delays - Single delay or array of delays per attempt
+ * @param attempt - Zero-based attempt index
+ * @returns Delay in milliseconds
+ */
+export declare function getRetryDelay(delays: number | readonly number[], attempt: number): number;
 //# sourceMappingURL=utils.d.ts.map

package/dist/client/lib/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/client/lib/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAMtD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/client/lib/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAMtD;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMzF"}

package/dist/client/namespaces/activity.d.ts

@@ -25,7 +25,7 @@ export declare class ActivityManager {
      * @param params - Activity parameters
      * @returns Started activity instance
      *
-     * @example
+     * @example Basic usage
      * ```typescript
      * const activity = timeback.activity.start({
      *   id: 'lesson-1',
@@ -36,8 +36,7 @@ export declare class ActivityManager {
      * await activity.end({
      *   totalQuestions: 10,
      *   correctQuestions: 8,
-     *   attemptNumber: 1,
-     *   pctCompleteApp: 67,
+     *   pctComplete: 67,
      * })
      * ```
      */

package/dist/client/namespaces/activity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../src/client/namespaces/activity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAE5E;;GAEG;AACH,qBAAa,eAAe;IAMf,OAAO,CAAC,QAAQ,CAAC,YAAY;IALzC;;;;OAIG;IACH,YAA6B,YAAY,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,EAAI;IAE7F;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CAEtC;CACD"}
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../src/client/namespaces/activity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAE5E;;GAEG;AACH,qBAAa,eAAe;IAMf,OAAO,CAAC,QAAQ,CAAC,YAAY;IALzC;;;;OAIG;IACH,YAA6B,YAAY,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,EAAI;IAE7F;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CAEtC;CACD"}

package/dist/client.d.ts

@@ -21,7 +21,7 @@
  * activity.resume()
  *
  * // End tracking with metrics
- * await activity.end({ totalQuestions: 10, correctQuestions: 8, attemptNumber: 1 })
+ * await activity.end({ totalQuestions: 10, correctQuestions: 8 })
  * ```
  */
 export { createClient, TimebackClient } from './client/index';

package/dist/client.js

@@ -1,257 +1 @@
-// src/shared/constants.ts
-var DEFAULT_BASE_PATH = "/api/timeback";
-var ROUTES = {
-  ACTIVITY: "/activity",
-  IDENTITY: {
-    SIGNIN: "/identity/signin",
-    SIGNOUT: "/identity/signout",
-    CALLBACK: "/identity/callback"
-  },
-  USER: {
-    ME: "/user/me",
-    VERIFY: "/user/verify"
-  }
-};
-
-// src/client/lib/utils.ts
-function isBrowser() {
-  return typeof window !== "undefined";
-}
-function getDefaultBaseURL() {
-  if (!isBrowser()) {
-    return;
-  }
-  return `${window.location.origin}${DEFAULT_BASE_PATH}`;
-}
-
-// src/client/lib/fetch.ts
-function getDefaultFetch() {
-  const globalFetch = typeof globalThis === "undefined" ? undefined : globalThis.fetch;
-  if (!globalFetch) {
-    return;
-  }
-  return (input, init) => globalThis.fetch(input, init);
-}
-
-// src/client/lib/activity/activity.class.ts
-class Activity {
-  params;
-  sendActivity;
-  _startedAt;
-  _isPaused = false;
-  _pausedAt;
-  _totalPausedMs = 0;
-  _ended = false;
-  constructor(params, sendActivity) {
-    this.params = params;
-    this.sendActivity = sendActivity;
-    this._startedAt = new Date;
-  }
-  get startedAt() {
-    return this._startedAt;
-  }
-  get isPaused() {
-    return this._isPaused;
-  }
-  get elapsedMs() {
-    if (this._ended) {
-      return 0;
-    }
-    const now = new Date;
-    let elapsed = now.getTime() - this._startedAt.getTime() - this._totalPausedMs;
-    if (this._isPaused && this._pausedAt) {
-      elapsed -= now.getTime() - this._pausedAt.getTime();
-    }
-    return Math.max(0, elapsed);
-  }
-  _buildPayload(data) {
-    const now = new Date;
-    const pausedMs = this._totalPausedMs + (this._isPaused && this._pausedAt ? now.getTime() - this._pausedAt.getTime() : 0);
-    const elapsedMs = now.getTime() - this._startedAt.getTime() - pausedMs;
-    return {
-      id: this.params.id,
-      name: this.params.name,
-      course: this.params.course,
-      startedAt: this._startedAt.toISOString(),
-      endedAt: now.toISOString(),
-      elapsedMs: Math.max(0, elapsedMs),
-      pausedMs,
-      metrics: {
-        totalQuestions: data.totalQuestions,
-        correctQuestions: data.correctQuestions,
-        ...data.xpEarned === undefined ? {} : { xpEarned: data.xpEarned },
-        ...data.masteredUnits === undefined ? {} : { masteredUnits: data.masteredUnits }
-      },
-      ...data.attemptNumber === undefined ? {} : { attemptNumber: data.attemptNumber },
-      ...data.pctCompleteApp === undefined ? {} : { pctCompleteApp: data.pctCompleteApp }
-    };
-  }
-  pause() {
-    if (this._isPaused || this._ended)
-      return;
-    this._isPaused = true;
-    this._pausedAt = new Date;
-  }
-  resume() {
-    if (!this._isPaused || this._ended || !this._pausedAt)
-      return;
-    this._totalPausedMs += new Date().getTime() - this._pausedAt.getTime();
-    this._isPaused = false;
-    this._pausedAt = undefined;
-  }
-  async end(data) {
-    if (this._ended)
-      return;
-    this._ended = true;
-    if (this._isPaused && this._pausedAt) {
-      this._totalPausedMs += new Date().getTime() - this._pausedAt.getTime();
-      this._isPaused = false;
-      this._pausedAt = undefined;
-    }
-    const payload = this._buildPayload(data);
-    await this.sendActivity(payload);
-  }
-}
-// src/client/namespaces/activity.ts
-class ActivityManager {
-  sendActivity;
-  constructor(sendActivity) {
-    this.sendActivity = sendActivity;
-  }
-  start(params) {
-    return new Activity(params, this.sendActivity);
-  }
-}
-// src/client/namespaces/auth.ts
-class Auth {
-  getBaseURL;
-  constructor(getBaseURL) {
-    this.getBaseURL = getBaseURL;
-  }
-  signIn() {
-    if (!isBrowser()) {
-      throw new Error("signIn() requires a browser environment");
-    }
-    window.location.href = `${this.getBaseURL()}${ROUTES.IDENTITY.SIGNIN}`;
-  }
-}
-// src/client/namespaces/user.ts
-class User {
-  getBaseURL;
-  fetchImpl;
-  constructor(getBaseURL, fetchImpl) {
-    this.getBaseURL = getBaseURL;
-    this.fetchImpl = fetchImpl;
-  }
-  async fetch() {
-    if (!isBrowser()) {
-      throw new Error("user.fetch() requires a browser environment");
-    }
-    const response = await this.fetchImpl(`${this.getBaseURL()}${ROUTES.USER.ME}`, {
-      method: "GET",
-      credentials: "include"
-    });
-    if (!response.ok) {
-      const errorResponse = await response.json().catch(() => ({ error: "Unknown error" }));
-      throw new Error(errorResponse.error ?? "Failed to fetch user profile");
-    }
-    return response.json();
-  }
-  async verify() {
-    if (!isBrowser()) {
-      throw new Error("user.verify() requires a browser environment");
-    }
-    const response = await this.fetchImpl(`${this.getBaseURL()}${ROUTES.USER.VERIFY}`, {
-      method: "GET",
-      credentials: "include"
-    });
-    if (!response.ok) {
-      const errorResponse = await response.json().catch(() => ({ error: "Unknown error" }));
-      throw new Error(errorResponse.error ?? "Failed to verify Timeback user");
-    }
-    const data = await response.json();
-    if (data.verified && data.timebackId) {
-      return { verified: true, timebackId: data.timebackId };
-    }
-    return { verified: false };
-  }
-}
-// src/client/timeback-client.class.ts
-class TimebackClient {
-  activity;
-  auth;
-  user;
-  _baseURL;
-  _fetch;
-  constructor(config = {}) {
-    this._baseURL = config.baseURL;
-    const baseFetch = config.fetch ?? getDefaultFetch();
-    if (!baseFetch) {
-      throw new Error("TimebackClient requires a fetch implementation. " + "Provide `fetch` in the constructor config for non-browser runtimes.");
-    }
-    const rawPlugins = config.plugins;
-    const plugins = Array.isArray(rawPlugins) ? rawPlugins : rawPlugins ? [rawPlugins] : [];
-    this._fetch = plugins.reduce((f, p) => p.wrapFetch(f), baseFetch);
-    this.activity = new ActivityManager((payload) => this.sendActivity(payload));
-    this.auth = new Auth(() => this.baseURL);
-    this.user = new User(() => this.baseURL, this._fetch);
-  }
-  get baseURL() {
-    if (!this._baseURL) {
-      const resolved = getDefaultBaseURL();
-      if (!resolved) {
-        throw new Error("Timeback client requires a browser environment for default baseURL. " + "Provide an explicit baseURL for server-side usage.");
-      }
-      this._baseURL = resolved;
-    }
-    return this._baseURL;
-  }
-  async sendActivity(payload) {
-    const response = await this._fetch(`${this.baseURL}${ROUTES.ACTIVITY}`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(payload),
-      credentials: "include"
-    });
-    if (!response.ok) {
-      const errorResponse = await response.json().catch(() => ({ error: "Unknown error" }));
-      throw new Error(errorResponse.error ?? "Failed to send activity");
-    }
-  }
-}
-
-// src/client/timeback-client.ts
-function createClient(config = {}) {
-  const baseURL = config.baseURL ?? getDefaultBaseURL();
-  return new TimebackClient({
-    baseURL,
-    fetch: config.fetch,
-    plugins: config.plugins
-  });
-}
-// src/client/auth/bearer.ts
-function bearer(options) {
-  const headerName = options.headerName ?? "Authorization";
-  const prefix = options.prefix ?? "Bearer ";
-  return {
-    wrapFetch(fetchImpl) {
-      return async (input, init) => {
-        const token = await options.getToken();
-        if (!token) {
-          throw new Error("Missing bearer token (are you authenticated yet?)");
-        }
-        const headers = new Headers(init?.headers ?? (input instanceof Request ? input.headers : undefined));
-        if (!headers.has(headerName)) {
-          headers.set(headerName, `${prefix}${token}`);
-        }
-        return fetchImpl(input, { ...init, headers });
-      };
-    }
-  };
-}
-export {
-  createClient,
-  bearer,
-  TimebackClient,
-  Activity
-};
+import{e as o,f as y,g as b}from"./chunk-8gg8n8v9.js";function r(e){let i=e.headerName??"Authorization",k=e.prefix??"Bearer ";return{wrapFetch(s){return async(t,m)=>{let a=await e.getToken();if(!a)throw Error("Missing bearer token (are you authenticated yet?)");let c=new Headers(m?.headers??(t instanceof Request?t.headers:void 0));if(!c.has(i))c.set(i,`${k}${a}`);return s(t,{...m,headers:c})}}}}export{b as createClient,r as bearer,y as TimebackClient,o as Activity};