@timeback/sdk 0.1.4 → 0.1.6

package/dist/shared/types.d.ts

@@ -47,6 +47,8 @@ export interface TimebackProfile {
         dailyXp?: number;
         dailyLessons?: number;
         dailyActiveMinutes?: number;
+        dailyAccuracy?: number;
+        dailyMasteredUnits?: number;
     };
 }
 /**
@@ -96,23 +98,104 @@ export interface TimebackAuthUser extends TimebackProfile {
     claims: IdentityClaims;
 }
 /**
- * Course selector for activity tracking.
+ * Course selector by subject and grade (grade-based apps).
  *
- * This should correspond to a unique course entry in `timeback.config.ts`.
+ * Use this for traditional K-12 apps where courses are identified by subject + grade.
  */
-export interface ActivityCourseRef {
+export interface SubjectGradeCourseRef {
     subject: TimebackSubject;
     grade: TimebackGrade;
 }
+/**
+ * Course selector by code (grade-less apps).
+ *
+ * Use this for apps without grade levels (e.g., CS platforms) where courses
+ * are identified by a unique course code.
+ */
+export interface CourseCodeRef {
+    code: string;
+}
+/**
+ * Course selector for activity tracking.
+ *
+ * This should correspond to a unique course entry in `timeback.config.json`.
+ *
+ * Two selector modes are supported:
+ * - **Grade-based**: `{ subject, grade }` — K-12 style
+ * - **Grade-less**: `{ code }` — CS/skill-based
+ *
+ * @example Grade-based
+ * ```typescript
+ * { subject: 'Math', grade: 3 }
+ * ```
+ *
+ * @example Grade-less
+ * ```typescript
+ * { code: 'CS-101' }
+ * ```
+ */
+export type ActivityCourseRef = SubjectGradeCourseRef | CourseCodeRef;
+/**
+ * Type guard: Check if a course ref uses subject+grade identity.
+ *
+ * @param ref - Course reference to check
+ * @returns True if grade-based selector
+ */
+export declare function isSubjectGradeCourseRef(ref: ActivityCourseRef): ref is SubjectGradeCourseRef;
 /**
  * Activity start parameters.
+ *
+ * @remarks
+ * The `id` field is treated as a **slug** (not a URL). The SDK derives the
+ * canonical activity URL (`event.object.id`) from:
+ * - The configured sensor URL
+ * - The course selector (subject + grade or code)
+ * - This slug (URI-encoded)
+ *
+ * This allows upstream systems to process activities without requiring
+ * pre-synced OneRoster component resources.
+ *
+ * @example
+ * ```typescript
+ * // Grade-based course
+ * timeback.activity.start({
+ *   id: 'fractions-with-like-denominators', // slug
+ *   name: 'Fractions with Like Denominators', // human-readable
+ *   course: { subject: 'Math', grade: 3 },
+ * })
+ * // => object.id: https://sensor.example.com/activities/Math/g3/fractions-with-like-denominators
+ *
+ * // Grade-less course
+ * timeback.activity.start({
+ *   id: 'intro-to-loops',
+ *   name: 'Introduction to Loops',
+ *   course: { code: 'CS-101' },
+ * })
+ * // => object.id: https://sensor.example.com/activities/CS-101/intro-to-loops
+ * ```
  */
 export interface ActivityParams {
-    /** Unique identifier for the learning object */
+    /**
+     * Activity slug (stable identifier for the learning object).
+     *
+     * This is used to construct the canonical activity URL sent to Caliper.
+     * Use a short, URL-safe slug like `"fractions-with-like-denominators"` or
+     * `"lesson-1"`. Special characters will be URI-encoded.
+     *
+     * @example 'fractions-with-like-denominators'
+     * @example 'ccss.math.content.3.nf.a.1'
+     * @example 'lesson-1'
+     */
     id: string;
-    /** Display name of the activity */
+    /**
+     * Human-readable display name of the activity.
+     *
+     * This is sent as `object.activity.name` in Caliper events.
+     *
+     * @example 'Fractions with Like Denominators'
+     */
     name: string;
-    /** Course selector (must match a unique course in timeback.config.ts) */
+    /** Course selector (must match a unique course in timeback.config.json) */
     course: ActivityCourseRef;
 }
 /**
@@ -130,13 +213,23 @@ export interface ActivityMetrics {
 }
 /**
  * Activity state sent to the server when ending.
+ *
+ * @see {@link ActivityParams} for documentation on `id` and `name` semantics.
  */
 export interface ActivityEndPayload {
-    /** Unique identifier for the learning object */
+    /**
+     * Activity slug (stable identifier for the learning object).
+     *
+     * @see {@link ActivityParams.id}
+     */
     id: string;
-    /** Display name of the activity */
+    /**
+     * Human-readable display name of the activity.
+     *
+     * @see {@link ActivityParams.name}
+     */
     name: string;
-    /** Course selector (must match a unique course in timeback.config.ts) */
+    /** Course selector (must match a unique course in timeback.config.json) */
     course: ActivityCourseRef;
     /** ISO 8601 timestamp when activity started */
     startedAt: string;
@@ -148,6 +241,22 @@ export interface ActivityEndPayload {
     pausedMs: number;
     /** Activity metrics */
     metrics: ActivityMetrics;
+    /**
+     * Attempt number for this activity (1-based).
+     *
+     * If provided, this is forwarded to Caliper events as `generated.attempt`.
+     */
+    attemptNumber?: number;
+    /**
+     * App-reported course progress (per enrollment), as a percentage from 0–100.
+     *
+     * This is forwarded to Caliper events as `generated.extensions.pctCompleteApp`.
+     *
+     * @remarks
+     * - Scale: 0 to 100 (not 0 to 1)
+     * - Values outside 0–100 are clamped by the SDK server handler if present
+     */
+    pctCompleteApp?: number;
 }
 /**
  * Activity submission response.

package/dist/shared/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@timeback/sdk",
-	"version": "0.1.4",
+	"version": "0.1.6",
 	"description": "Timeback SDK for frontend and backend integration",
 	"type": "module",
 	"exports": {
@@ -12,10 +12,6 @@
 			"types": "./dist/client.d.ts",
 			"import": "./dist/client.js"
 		},
-		"./config": {
-			"types": "./dist/config.d.ts",
-			"import": "./dist/config.js"
-		},
 		"./identity": {
 			"types": "./dist/identity.d.ts",
 			"import": "./dist/identity.js"
@@ -81,12 +77,12 @@
 		"test": "bun test --no-env-file unit.test.ts"
 	},
 	"dependencies": {
-		"@timeback/core": "0.1.2",
-		"jiti": "^2.6.1",
+		"@timeback/core": "0.1.3",
+		"c12": "^3.3.3",
 		"zod": "^4.2.1"
 	},
 	"devDependencies": {
-		"@timeback/caliper": "0.1.1",
+		"@timeback/caliper": "0.1.2",
 		"@timeback/internal-cli-infra": "0.0.0",
 		"@timeback/internal-logger": "0.0.0",
 		"@timeback/internal-utils": "0.0.0",

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

@@ -1,16 +0,0 @@
-/**
- * Activity Factory
- *
- * Factory function for creating activity trackers.
- */
-import { Activity } from './activity.class';
-import type { ActivityEndPayload, ActivityParams } from '../../../shared/types';
-/**
- * Create an activity tracker.
- *
- * @param params - Activity parameters
- * @param sendActivity - Function to send activity to server
- * @returns Activity handle
- */
-export declare function createActivity(params: ActivityParams, sendActivity: (payload: ActivityEndPayload) => Promise<void>): Activity;
-//# sourceMappingURL=activity.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../../src/client/lib/activity/activity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE/E;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,GAC1D,QAAQ,CAEV"}

package/dist/config.d.ts

@@ -1,20 +0,0 @@
-/**
- * Types for `timeback.config.ts` (app configuration).
- *
- * This module is intended to be imported via the subpath export:
- *
- * ```ts
- * import type { TimebackConfig } from '@timeback/sdk/config'
- * ```
- *
- * Note: `TimebackConfig` here refers to the **app config file** shape, not the
- * SDK initialization config exported from `timeback`'s main entrypoint.
- */
-/**
- * App configuration type used by `timeback.config.ts`.
- *
- * Alias of `AppConfig`, exported under the name commonly used by consumers.
- */
-export type { AppConfig as TimebackConfig, AppConfig } from './server/types';
-export {};
-//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AACH,YAAY,EAAE,SAAS,IAAI,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE5E,OAAO,EAAE,CAAA"}

package/dist/server/lib/resolve-activity-course.d.ts

@@ -1,22 +0,0 @@
-import type { ActivityCourseRef } from '../../shared/types';
-import type { AppConfig } from '../types';
-/**
- * Resolve a course config entry from an activity course selector.
- *
- * @param courses - Configured courses from `timeback.config.ts`
- * @param courseRef - Course selector sent from the client
- * @returns Matched course config entry
- * @throws {ActivityCourseResolutionError} When selector is unknown or ambiguous
- */
-export declare function resolveActivityCourse(courses: AppConfig['courses'], courseRef: ActivityCourseRef): AppConfig['courses'][number];
-/**
- * Error thrown when a client-provided course selector cannot be resolved against config.
- */
-export declare class ActivityCourseResolutionError extends Error {
-    readonly code: 'unknown_course' | 'ambiguous_course';
-    readonly subject: ActivityCourseRef['subject'];
-    readonly grade: ActivityCourseRef['grade'];
-    readonly count?: number;
-    constructor(code: ActivityCourseResolutionError['code'], courseRef: ActivityCourseRef, count?: number);
-}
-//# sourceMappingURL=resolve-activity-course.d.ts.map

package/dist/server/lib/resolve-activity-course.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve-activity-course.d.ts","sourceRoot":"","sources":["../../../src/server/lib/resolve-activity-course.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,EAC7B,SAAS,EAAE,iBAAiB,GAC1B,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAc9B;AAED;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACvD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,kBAAkB,CAAA;IACpD,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAA;IAC9C,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IAEvB,YACC,IAAI,EAAE,6BAA6B,CAAC,MAAM,CAAC,EAC3C,SAAS,EAAE,iBAAiB,EAC5B,KAAK,CAAC,EAAE,MAAM,EAOd;CACD"}

package/dist/server/lib/resolve-timeback-id.d.ts

@@ -1,28 +0,0 @@
-import { TimebackUserResolutionError } from './resolve-timeback-user';
-import type { TimebackClient } from '@timeback/core';
-import type { ApiCredentials, Environment, IdentityConfig } from '../types';
-/**
- * Map a Timeback user resolution error code to an HTTP status for handlers.
- *
- * @param err - Timeback user resolution error
- * @returns HTTP status code
- */
-export declare function resolveStatusForUserResolutionError(err: TimebackUserResolutionError): number;
-/**
- * Resolve the canonical Timeback user ID for server-side activity submission.
- *
- * @param params - Resolution parameters
- * @returns Timeback user ID
- * @throws {TimebackUserResolutionError} When resolution fails
- */
-export declare function resolveTimebackIdForActivity(params: {
-    env: Environment;
-    api: ApiCredentials;
-    identity: IdentityConfig;
-    user: {
-        id: string;
-        email: string;
-    };
-    client: TimebackClient;
-}): Promise<string>;
-//# sourceMappingURL=resolve-timeback-id.d.ts.map

package/dist/server/lib/resolve-timeback-id.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve-timeback-id.d.ts","sourceRoot":"","sources":["../../../src/server/lib/resolve-timeback-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAEjG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAE3E;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,2BAA2B,GAAG,MAAM,CAE5F;AAED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAAC,MAAM,EAAE;IAC1D,GAAG,EAAE,WAAW,CAAA;IAChB,GAAG,EAAE,cAAc,CAAA;IACnB,QAAQ,EAAE,cAAc,CAAA;IACxB,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACnC,MAAM,EAAE,cAAc,CAAA;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBlB"}

package/dist/server/lib/resolve-timeback-user.d.ts

@@ -1,42 +0,0 @@
-/**
- * Timeback User Resolution
- *
- * Resolves the Timeback user by email using server credentials.
- */
-import { TimebackClient } from '@timeback/core';
-import type { TimebackAuthUser } from '../../shared/types';
-import type { ApiCredentials, Environment, OIDCUserInfo, TimebackUserResolutionErrorCode } from '../types';
-/**
- * Error thrown when Timeback user resolution fails.
- */
-export declare class TimebackUserResolutionError extends Error {
-    readonly code: TimebackUserResolutionErrorCode;
-    constructor(message: string, code: TimebackUserResolutionErrorCode);
-}
-interface ResolveTimebackUserByEmailParams {
-    /** Environment (staging/production) */
-    env: Environment;
-    /** API credentials for Timeback API */
-    apiCredentials: ApiCredentials;
-    /** OIDC user info from the IdP */
-    userInfo: OIDCUserInfo;
-    /**
-     * Optional pre-configured Timeback client to use (e.g. `timeback.api`).
-     *
-     * When provided, this function will use it and will NOT close it.
-     */
-    client?: TimebackClient;
-}
-/**
- * Resolve a TimebackAuthUser by looking up the Timeback user via email.
- *
- * Uses server API credentials to query OneRoster for a user matching the IdP email.
- * Strict mode: fails if no user found or if multiple users match (ambiguous).
- *
- * @param params - Resolution parameters
- * @returns Resolved TimebackAuthUser with Timeback profile and IdP claims
- * @throws {TimebackUserResolutionError} If resolution fails
- */
-export declare function resolveTimebackUserByEmail(params: ResolveTimebackUserByEmailParams): Promise<TimebackAuthUser>;
-export {};
-//# sourceMappingURL=resolve-timeback-user.d.ts.map

package/dist/server/lib/resolve-timeback-user.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve-timeback-user.d.ts","sourceRoot":"","sources":["../../../src/server/lib/resolve-timeback-user.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAM/C,OAAO,KAAK,EAAkB,gBAAgB,EAAmB,MAAM,oBAAoB,CAAA;AAC3F,OAAO,KAAK,EACX,cAAc,EACd,WAAW,EACX,YAAY,EACZ,+BAA+B,EAC/B,MAAM,UAAU,CAAA;AAIjB;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;aAGpC,IAAI,EAAE,+BAA+B;IAFtD,YACC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,+BAA+B,EAIrD;CACD;AAED,UAAU,gCAAgC;IACzC,uCAAuC;IACvC,GAAG,EAAE,WAAW,CAAA;IAChB,uCAAuC;IACvC,cAAc,EAAE,cAAc,CAAA;IAC9B,kCAAkC;IAClC,QAAQ,EAAE,YAAY,CAAA;IACtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,cAAc,CAAA;CACvB;AAkBD;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC/C,MAAM,EAAE,gCAAgC,GACtC,OAAO,CAAC,gBAAgB,CAAC,CAuG3B"}