@timeback/sdk 0.1.4 → 0.1.6

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;;GAEG;AACH,qBAAa,QAAQ;IAgBnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAhB9B,OAAO,CAAC,UAAU,CAAkB;IACpC,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,EAC1E;IAEJ;;;;OAIG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;OAIG;IACH,IAAI,SAAS,IAAI,IAAI,GAAG,SAAS,CAEhC;IAED;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAIZ;IAED;;;;OAIG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;OAIG;IACH,IAAI,SAAS,IAAI,MAAM,CAatB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAIZ;IAED;;OAEG;IACH,MAAM,IAAI,IAAI,CAKb;IAED;;;;;OAKG;IACG,GAAG,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BjD;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,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"}

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

@@ -1,6 +1,5 @@
 /**
  * Activity Module
  */
-export { createActivity } from './activity';
 export { Activity } from './activity.class';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/lib/activity/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/lib/activity/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA"}

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

@@ -6,7 +6,7 @@
 import { Activity } from '../lib/activity';
 import type { ActivityEndPayload, ActivityParams } from '../../shared/types';
 /**
- * Activity namespace for creating and managing activities.
+ * Activity namespace for starting and managing activities.
  */
 export declare class ActivityManager {
     private readonly sendActivity;
@@ -17,25 +17,30 @@ export declare class ActivityManager {
      */
     constructor(sendActivity: (payload: ActivityEndPayload) => Promise<void>);
     /**
-     * Create a new activity.
+     * Start a new activity.
      *
-     * The activity is created but not started. Call `.start()` to begin tracking.
+     * The activity timer begins immediately. Use `pause()`, `resume()`, and `end()`
+     * to control the activity lifecycle.
      *
      * @param params - Activity parameters
-     * @returns Activity instance
+     * @returns Started activity instance
      *
      * @example
      * ```typescript
-     * const activity = timeback.activity.new({
+     * const activity = timeback.activity.start({
      *   id: 'lesson-1',
      *   name: 'Intro',
      *   course: { subject: 'Math', grade: 3 },
      * })
-     * activity.start()
      * // ... user completes lesson ...
-     * await activity.end({ totalQuestions: 10, correctQuestions: 8 })
+     * await activity.end({
+     *   totalQuestions: 10,
+     *   correctQuestions: 8,
+     *   attemptNumber: 1,
+     *   pctCompleteApp: 67,
+     * })
      * ```
      */
-    new(params: ActivityParams): Activity;
+    start(params: ActivityParams): Activity;
 }
 //# sourceMappingURL=activity.d.ts.map

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;;;;;;;;;;;;;;;;;;;OAmBG;IACH,GAAG,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CAEpC;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;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CAEtC;CACD"}

package/dist/client.d.ts

@@ -10,10 +10,10 @@
  * const client = createClient()
  *
  * // Start tracking
- * const activity = client.startActivity({
+ * const activity = client.activity.start({
  *   id: 'lesson-123',
  *   name: 'Algebra Basics',
- *   course: { subject: 'FastMath', grade: 3 },
+ *   course: { subject: 'Math', grade: 3 },
  * })
  *
  * // Pause/resume
@@ -21,10 +21,10 @@
  * activity.resume()
  *
  * // End tracking with metrics
- * await activity.end({ totalQuestions: 10, correctQuestions: 8 })
+ * await activity.end({ totalQuestions: 10, correctQuestions: 8, attemptNumber: 1 })
  * ```
  */
 export { createClient, TimebackClient } from './client/index';
-export { createActivity, Activity } from './client/index';
+export { Activity } from './client/index';
 export type { TimebackIdentity, TimebackProfile, TimebackSessionUser, ActivityParams, ActivityMetrics, } from './shared/types';
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzD,YAAY,EACX,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,eAAe,GACf,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,YAAY,EACX,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,eAAe,GACf,MAAM,gBAAgB,CAAA"}

package/dist/client.js

@@ -35,24 +35,16 @@ class Activity {
   constructor(params, sendActivity) {
     this.params = params;
     this.sendActivity = sendActivity;
-  }
-  get isStarted() {
-    return this._startedAt !== undefined;
+    this._startedAt = new Date;
   }
   get startedAt() {
     return this._startedAt;
   }
-  start() {
-    if (this._startedAt)
-      return this;
-    this._startedAt = new Date;
-    return this;
-  }
   get isPaused() {
     return this._isPaused;
   }
   get elapsedMs() {
-    if (!this._startedAt || this._ended) {
+    if (this._ended) {
       return 0;
     }
     const now = new Date;
@@ -62,8 +54,30 @@ class Activity {
     }
     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._startedAt || this._isPaused || this._ended)
+    if (this._isPaused || this._ended)
       return;
     this._isPaused = true;
     this._pausedAt = new Date;
@@ -75,43 +89,26 @@ class Activity {
     this._isPaused = false;
     this._pausedAt = undefined;
   }
-  async end(metrics) {
-    if (!this._startedAt) {
-      throw new Error("Cannot end activity that was never started");
-    }
+  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 endedAt = new Date;
-    const elapsedMs = endedAt.getTime() - this._startedAt.getTime() - this._totalPausedMs;
-    const payload = {
-      id: this.params.id,
-      name: this.params.name,
-      course: this.params.course,
-      startedAt: this._startedAt.toISOString(),
-      endedAt: endedAt.toISOString(),
-      elapsedMs: Math.max(0, elapsedMs),
-      pausedMs: this._totalPausedMs,
-      metrics
-    };
+    const payload = this._buildPayload(data);
     await this.sendActivity(payload);
   }
 }
-
-// src/client/lib/activity/activity.ts
-function createActivity(params, sendActivity) {
-  return new Activity(params, sendActivity);
-}
 // src/client/namespaces/activity.ts
 class ActivityManager {
   sendActivity;
   constructor(sendActivity) {
     this.sendActivity = sendActivity;
   }
-  new(params) {
+  start(params) {
     return new Activity(params, this.sendActivity);
   }
 }
@@ -192,7 +189,6 @@ function createClient(config = {}) {
 }
 export {
   createClient,
-  createActivity,
   TimebackClient,
   Activity
 };

package/dist/edge.d.ts

@@ -2,7 +2,7 @@
  * Timeback (edge/worker friendly entrypoint)
  *
  * This entrypoint is intended for runtimes like Cloudflare Workers / workerd.
- * It avoids importing Node-only dependencies (notably config loading via `jiti`).
+ * It avoids importing Node-only dependencies (notably config loading via `c12`).
  *
  * It includes identity-only SSO plus a small set of edge-safe helpers.
  */

package/dist/index.d.ts

@@ -15,11 +15,7 @@
  *   },
  *   identity: {
  *     mode: 'custom',
- *     getUser: async (req) => ({
- *       id: session.userId,
- *       email: session.user.email,
- *       name: session.user.name,
- *     }),
+ *     getEmail: req => getSessionFromCookie(req)?.email,
  *   },
  * })
  * ```

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAE/C,YAAY,EACX,cAAc,EACd,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,kCAAkC,EAClC,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,OAAO,EACP,+BAA+B,GAC/B,MAAM,UAAU,CAAA;AAEjB,YAAY,EACX,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,eAAe,GACf,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAE/C,YAAY,EACX,cAAc,EACd,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,kCAAkC,EAClC,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,OAAO,EACP,+BAA+B,GAC/B,MAAM,UAAU,CAAA;AAEjB,YAAY,EACX,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,eAAe,GACf,MAAM,gBAAgB,CAAA"}