@timeback/sdk 0.1.9 → 0.1.11

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

@@ -3,33 +3,5 @@
  *
  * Types for Svelte-specific stores.
  */
-import type { TimebackProfile } from '../../../shared/types';
-/**
- * Verification state for the current user.
- */
-export type TimebackVerificationState = {
-    status: 'loading';
-} | {
-    status: 'verified';
-    timebackId: string;
-} | {
-    status: 'unverified';
-} | {
-    status: 'error';
-    message: string;
-};
-/**
- * Profile state for the current user.
- */
-export type TimebackProfileState = {
-    status: 'idle';
-} | {
-    status: 'loading';
-} | {
-    status: 'loaded';
-    profile: TimebackProfile;
-} | {
-    status: 'error';
-    message: string;
-};
+export type { TimebackProfileState, TimebackVerificationState } from '../../../shared/types';
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/svelte/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAClC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GACxB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvC;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC7B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GAC9C;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/svelte/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/vue/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAGrD,OAAO,KAAK,EAAgB,QAAQ,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAqC7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,gBAAgB;IAG3B,wFAAwF;;;;;;;;IAAxF,wFAAwF;;;;;;;0FAoBxF,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,WAAW,IAAI,UAAU,CAAC,cAAc,GAAG,SAAS,CAAC,CAQpE"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/vue/provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAIrD,OAAO,KAAK,EAAgB,QAAQ,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AA2B7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,gBAAgB;IAG3B,wFAAwF;;;;;;;;IAAxF,wFAAwF;;;;;;;0FAoBxF,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,WAAW,IAAI,UAAU,CAAC,cAAc,GAAG,SAAS,CAAC,CAQpE"}

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

@@ -1,6 +1,9 @@
-import { TimebackClient } from '@timeback/sdk/client'
 import { defineComponent, inject, onMounted, provide, shallowRef } from 'vue'
 
+import { TimebackClient } from '@timeback/sdk/client'
+
+import { isBrowser } from '../../lib/utils'
+
 import type { InjectionKey, PropType, ShallowRef } from 'vue'
 
 /**
@@ -14,16 +17,6 @@ import type { InjectionKey, PropType, ShallowRef } from 'vue'
  */
 const TimebackKey: InjectionKey<ShallowRef<TimebackClient | undefined>> = Symbol('timeback')
 
-/**
- * Check if we're running in the browser.
- *
- * @returns True if in browser
- */
-function isBrowser(): boolean {
-	return typeof window !== 'undefined'
-}
-
-// Singleton client instance for browser
 let clientInstance: TimebackClient | undefined
 
 /**

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

@@ -3,35 +3,8 @@
  *
  * 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;
-};
+import type { TimebackProfileState, TimebackVerificationState } from '../../../shared/types';
+export type { TimebackProfileState, TimebackVerificationState } from '../../../shared/types';
 /**
  * Options for the useTimebackVerification composable.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/vue/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,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,6BAA6B;IAC7C,gDAAgD;IAChD,KAAK,EAAE,yBAAyB,CAAA;IAEhC,qDAAqD;IACrD,OAAO,EAAE,MAAM,IAAI,CAAA;CACnB;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,2CAA2C;IAC3C,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/vue/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,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,6BAA6B;IAC7C,gDAAgD;IAChD,KAAK,EAAE,yBAAyB,CAAA;IAEhC,qDAAqD;IACrD,OAAO,EAAE,MAAM,IAAI,CAAA;CACnB;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,2CAA2C;IAC3C,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/vue/types.ts

@@ -4,25 +4,9 @@
  * Types for Vue-specific composables.
  */
 
-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 the useTimebackVerification composable.

package/dist/client/auth/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * Client Auth Types
  *
- * Small, framework-agnostic extension point for customizing how the SDK makes HTTP requests.
+ * Extension point for customizing how the SDK makes HTTP requests.
  */
 export type TimebackFetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
 /**

package/dist/client/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Client Module
  *
- * Framework-agnostic client exports.
+ * Client exports.
  */
 export { createClient } from './timeback-client';
 export { TimebackClient } from './timeback-client.class';

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

@@ -1,32 +1,56 @@
 /**
  * Activity Class
  *
- * Client-side activity tracking logic.
+ * Client-side activity tracking with continuous time-spent reporting.
  */
-import type { ActivityEndData, ActivityEndPayload, ActivityParams } from '../../../shared/types';
+import type { ActivityEndData, ActivityParams } from '../../../shared/types';
+import type { ActivityCallbacks } from './types';
 /**
- * Activity tracker that tracks time spent on an activity.
+ * Activity tracker with continuous heartbeat reporting.
  *
- * Activities are started immediately on construction. Use `pause()`, `resume()`,
+ * Activities are started immediately on construction. Heartbeats are sent
+ * at regular intervals to report time spent. Use `pause()`, `resume()`,
  * and `end()` to control the activity lifecycle.
  */
 export declare class Activity {
     private readonly params;
-    private readonly sendActivity;
+    /** Activity slug passed to `start()`. */
+    readonly id: string;
+    readonly runId: string;
     private readonly _startedAt;
+    private readonly _timeEnabled;
+    private readonly _timeOptions;
+    private readonly _callbacks;
+    private _windowStartMs;
+    private _activeSinceMs;
+    private _accumulatedActiveMs;
+    private _totalFlushedActiveMs;
     private _isPaused;
-    private _pausedAt;
-    private _totalPausedMs;
     private _ended;
+    private _ending;
+    private _heartbeatTimer;
+    private _flushInFlight;
+    private _boundVisibilityHandler;
+    private _boundPageHideHandler;
+    private _hiddenTimeoutTimer;
+    private _timedOutWhileHidden;
     /**
      * Create and start a new activity tracker.
      *
-     * The activity timer begins immediately.
+     * The activity timer begins immediately. Heartbeats are sent at regular
+     * intervals (default: 15 seconds) to report accumulated time.
      *
      * @param params - Activity parameters
-     * @param sendActivity - Function to send activity to server
+     * @param callbacks - Network operation callbacks
      */
-    constructor(params: ActivityParams, sendActivity: (payload: ActivityEndPayload) => Promise<void>);
+    constructor(params: ActivityParams, callbacks: ActivityCallbacks);
+    /**
+     * Build an error context object for the `onError` callback.
+     *
+     * @param type - Which operation failed
+     * @returns Error context
+     */
+    private _errorContext;
     /**
      * When the activity was started.
      *
@@ -40,34 +64,118 @@ export declare class Activity {
      */
     get isPaused(): boolean;
     /**
-     * Total elapsed time in milliseconds (excluding paused time).
+     * Whether the activity has ended.
      *
-     * @returns Elapsed milliseconds (0 if ended)
+     * @returns True if `end()` completed successfully
+     */
+    get isEnded(): boolean;
+    /**
+     * Active time in the current heartbeat window in milliseconds.
+     *
+     * Resets to 0 after each flush (heartbeat). For total time across all
+     * windows, use {@link totalActiveMs}.
+     *
+     * @returns Active milliseconds in the current window
      */
     get elapsedMs(): number;
     /**
-     * Build the activity end payload without sending it.
+     * Total active time in milliseconds since the activity started.
      *
-     * Useful for "preview" flows in examples where you want to inspect the payload
-     * that would be POSTed to the server without calling `end()`.
+     * Accumulates across all flushed heartbeat windows plus the current
+     * in-progress window. Not affected by pause/resume or hidden timeouts
+     * (those reset the window but already-flushed time is preserved).
      *
-     * @param data - Activity completion data (metrics + optional time override)
-     * @returns Activity end payload
+     * @returns Total active milliseconds
+     */
+    get totalActiveMs(): number;
+    /**
+     * Get accumulated active time in the current window, including any in-progress period.
+     *
+     * @returns Active milliseconds in current window
      */
-    _buildPayload(data: ActivityEndData): ActivityEndPayload;
+    private _getCurrentWindowActiveMs;
     /**
-     * Pause the activity timer.
+     * Start the heartbeat interval timer.
+     */
+    private _startHeartbeatTimer;
+    /**
+     * Stop the heartbeat interval timer.
+     */
+    private _stopHeartbeatTimer;
+    /**
+     * Restart the heartbeat interval timer.
+     *
+     * Used after visibility-triggered flushes to ensure the next heartbeat
+     * fires at a full interval from when the page became visible again.
+     */
+    private _restartHeartbeatTimer;
+    /**
+     * Set up visibility and pagehide event listeners for time tracking.
+     */
+    private _setupVisibilityHandlers;
+    /**
+     * Clean up event listeners.
+     */
+    private _teardownVisibilityHandlers;
+    /**
+     * Handle visibility change events — pause/resume time accumulation and flush as configured.
+     */
+    private _handleVisibilityChange;
+    /**
+     * Start the hidden timeout timer.
+     *
+     * After this timeout expires, heartbeats stop and the tracking window
+     * resets when the user returns so the extended absence isn't counted.
+     */
+    private _startHiddenTimeout;
+    /**
+     * Clear the hidden timeout timer.
+     */
+    private _clearHiddenTimeout;
+    /**
+     * Handle pagehide events — best-effort flush via sendBeacon or fetch keepalive.
+     */
+    private _handlePageHide;
+    private _flushSync;
+    /**
+     * Build heartbeat payload for the current time window.
+     *
+     * @param endMs - End timestamp in milliseconds
+     * @param activeMs - Active time in milliseconds
+     * @returns Heartbeat payload
+     */
+    private _buildHeartbeatPayload;
+    /**
+     * Flush accumulated time to server.
+     *
+     * Serialized — only one flush can be in flight at a time. No-op when
+     * time tracking is disabled (`time: false`).
+     *
+     * @returns Promise that resolves when flush completes
+     */
+    flushTimeSpent(): Promise<void>;
+    /**
+     * Pause the activity.
+     *
+     * Flushes accumulated time, then stops heartbeats until `resume()` is called.
      */
     pause(): void;
     /**
-     * Resume the activity timer.
+     * Resume the activity.
+     *
+     * Starts a fresh tracking window and restarts heartbeats.
      */
     resume(): void;
     /**
-     * End the activity and send to server.
+     * End the activity.
+     *
+     * Performs a final heartbeat flush then sends the completion event
+     * (if metrics or pctComplete are provided). If the network call fails,
+     * the activity remains usable so the consumer can retry.
      *
      * @param data - Activity completion data (metrics + optional time override)
      */
-    end(data: ActivityEndData): Promise<void>;
+    end(data?: ActivityEndData): Promise<void>;
+    private _sendCompletion;
 }
 //# 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,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"}
+{"version":3,"file":"activity.class.d.ts","sourceRoot":"","sources":["../../../../src/client/lib/activity/activity.class.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EACX,eAAe,EAGf,cAAc,EAGd,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD;;;;;;GAMG;AACH,qBAAa,QAAQ;IAsCnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IArCxB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IAEtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAM;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAE9C,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,cAAc,CAAe;IACrC,OAAO,CAAC,oBAAoB,CAAI;IAChC,OAAO,CAAC,qBAAqB,CAAI;IAEjC,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAQ;IAEvB,OAAO,CAAC,eAAe,CAA8C;IAErE,OAAO,CAAC,cAAc,CAA6B;IAEnD,OAAO,CAAC,uBAAuB,CAA4B;IAC3D,OAAO,CAAC,qBAAqB,CAA4B;IACzD,OAAO,CAAC,mBAAmB,CAA6C;IACxE,OAAO,CAAC,oBAAoB,CAAQ;IAEpC;;;;;;;;OAQG;IACH,YACkB,MAAM,EAAE,cAAc,EACvC,SAAS,EAAE,iBAAiB,EA+B5B;IAED;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;OAIG;IACH,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED;;;;OAIG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;OAIG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;;;OAOG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;;;;;;OAQG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAUjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAK9B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAchC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAcnC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA0C/B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,eAAe;YAuBT,UAAU;IAoBxB;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAe9B;;;;;;;OAOG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CA0DpC;IAED;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAcZ;IAED;;;;OAIG;IACH,MAAM,IAAI,IAAI,CAkBb;IAED;;;;;;;;OAQG;IACG,GAAG,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDnD;YAOa,eAAe;CA4C7B"}

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

@@ -0,0 +1,15 @@
+/**
+ * Activity Transport
+ *
+ * HTTP transport for activity heartbeats and submissions.
+ * Encapsulates page-exit transport policy (sendBeacon vs keepalive fetch).
+ */
+import type { ActivityTransport, ActivityTransportConfig } from './types';
+/**
+ * Create activity transport.
+ *
+ * @param config - Transport configuration
+ * @returns Activity transport
+ */
+export declare function createActivityTransport(config: ActivityTransportConfig): ActivityTransport;
+//# sourceMappingURL=transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../src/client/lib/activity/transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAEzE;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAmH1F"}

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

@@ -0,0 +1,53 @@
+/**
+ * Activity Module Types
+ *
+ * Internal types for activity tracking.
+ */
+import type { ActivityHeartbeatPayload, ActivitySubmitPayload } from '../../../shared/types';
+import type { TimebackFetch } from '../../auth/types';
+/**
+ * Callbacks for activity network operations.
+ */
+export interface ActivityCallbacks {
+    /** Send heartbeat (normal) */
+    sendHeartbeat: (payload: ActivityHeartbeatPayload) => Promise<void>;
+    /** Send heartbeat on page exit (beacon/keepalive) */
+    sendHeartbeatOnPageHide: (payload: ActivityHeartbeatPayload) => Promise<void>;
+    /** Send completion */
+    sendSubmit: (payload: ActivitySubmitPayload) => Promise<void>;
+}
+/**
+ * Configuration for activity transport.
+ */
+export interface ActivityTransportConfig {
+    /** Base URL for Timeback API routes */
+    baseURL: string;
+    /** Fetch implementation (possibly plugin-wrapped) */
+    fetch: TimebackFetch;
+    /**
+     * Whether sendBeacon is safe to use on page exit.
+     *
+     * False when fetch plugins are present (e.g. for bearer token auth),
+     * since sendBeacon cannot set Authorization headers.
+     */
+    canUseBeacon: boolean;
+    /**
+     * Credentials policy for fetch requests.
+     *
+     * Defaults to `'include'` (sends cookies cross-origin). Use `'same-origin'`
+     * or `'omit'` for token-based or cross-origin setups where cookies are not needed.
+     */
+    credentials: RequestCredentials;
+}
+/**
+ * Activity transport interface.
+ */
+export interface ActivityTransport {
+    /** Send heartbeat (normal fetch) */
+    sendHeartbeat: (payload: ActivityHeartbeatPayload) => Promise<void>;
+    /** Send heartbeat on page exit (beacon or keepalive fetch) */
+    sendHeartbeatOnPageHide: (payload: ActivityHeartbeatPayload) => Promise<void>;
+    /** Send completion (normal fetch) */
+    sendSubmit: (payload: ActivitySubmitPayload) => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/client/lib/activity/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC5F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAMrD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,8BAA8B;IAC9B,aAAa,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACnE,qDAAqD;IACrD,uBAAuB,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7E,sBAAsB;IACtB,UAAU,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7D;AAMD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,KAAK,EAAE,aAAa,CAAA;IACpB;;;;;OAKG;IACH,YAAY,EAAE,OAAO,CAAA;IACrB;;;;;OAKG;IACH,WAAW,EAAE,kBAAkB,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,oCAAoC;IACpC,aAAa,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACnE,8DAA8D;IAC9D,uBAAuB,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7E,qCAAqC;IACrC,UAAU,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7D"}

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

@@ -32,4 +32,22 @@ export declare function sleep(ms: number): Promise<void>;
  * @returns Delay in milliseconds
  */
 export declare function getRetryDelay(delays: number | readonly number[], attempt: number): number;
+/**
+ * Execute an async operation with optional retry and exponential backoff.
+ *
+ * @param fn - The async operation to attempt
+ * @param attempts - Number of retries (0 = no retry, just one attempt)
+ * @param delays - Delay schedule between retries
+ * @returns The result of `fn`
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, attempts: number, delays: number | readonly number[]): Promise<T>;
+/**
+ * Generate a unique run identifier.
+ *
+ * Uses `crypto.randomUUID()` when available, with a Math.random() fallback
+ * for older browsers where crypto is unavailable.
+ *
+ * @returns Generated UUID string
+ */
+export declare function generateRunId(): string;
 //# 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;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"}
+{"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;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAChC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAChC,OAAO,CAAC,CAAC,CAAC,CAgBZ;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAWtC"}

package/dist/client/lib/utils.ts

@@ -0,0 +1,109 @@
+/**
+ * Client Utilities
+ *
+ * Internal utility functions for the client SDK.
+ */
+
+import { DEFAULT_BASE_PATH } from '../../shared/constants'
+
+/**
+ * Check if we're in a browser environment.
+ *
+ * @returns True if in browser
+ */
+export function isBrowser(): boolean {
+	return typeof window !== 'undefined'
+}
+
+/**
+ * Get the default base URL.
+ *
+ * Returns undefined during SSR - baseURL is resolved lazily on first API call.
+ *
+ * @returns The default base URL or undefined during SSR
+ */
+export function getDefaultBaseURL(): string | undefined {
+	if (!isBrowser()) {
+		return undefined
+	}
+
+	return `${window.location.origin}${DEFAULT_BASE_PATH}`
+}
+
+/**
+ * Sleep for a given number of milliseconds.
+ *
+ * @param ms - Duration to sleep in milliseconds
+ * @returns Promise that resolves after the delay
+ */
+export function sleep(ms: number): Promise<void> {
+	return new Promise<void>(resolve => {
+		setTimeout(resolve, ms)
+	})
+}
+
+/**
+ * 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 function getRetryDelay(delays: number | readonly number[], attempt: number): number {
+	if (typeof delays === 'number') {
+		return delays
+	}
+
+	return delays[Math.min(attempt, delays.length - 1)] ?? 1000
+}
+
+/**
+ * Execute an async operation with optional retry and exponential backoff.
+ *
+ * @param fn - The async operation to attempt
+ * @param attempts - Number of retries (0 = no retry, just one attempt)
+ * @param delays - Delay schedule between retries
+ * @returns The result of `fn`
+ */
+export async function withRetry<T>(
+	fn: () => Promise<T>,
+	attempts: number,
+	delays: number | readonly number[],
+): Promise<T> {
+	let lastError: unknown
+
+	for (let attempt = 0; attempt <= attempts; attempt++) {
+		try {
+			return await fn()
+		} catch (error: unknown) {
+			lastError = error
+
+			if (attempt < attempts) {
+				await sleep(getRetryDelay(delays, attempt))
+			}
+		}
+	}
+
+	throw lastError instanceof Error ? lastError : new Error(String(lastError))
+}
+
+/**
+ * Generate a unique run identifier.
+ *
+ * Uses `crypto.randomUUID()` when available, with a Math.random() fallback
+ * for older browsers where crypto is unavailable.
+ *
+ * @returns Generated UUID string
+ */
+export function generateRunId(): string {
+	if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+		return crypto.randomUUID()
+	}
+
+	// Fallback for environments without crypto.randomUUID
+	return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
+		const r = (Math.random() * 16) | 0
+		const v = c === 'x' ? r : (r & 0x3) | 0x8
+		return v.toString(16)
+	})
+}