@timeback/sdk 0.1.5 → 0.1.7

package/dist/server/adapters/utils.d.ts

@@ -12,7 +12,7 @@ type AnyHandlers = Handlers | IdentityOnlyHandlers;
 /**
  * A canonical route identifier for Timeback's built-in endpoints.
  */
-type TimebackRouteId = 'identity.signIn' | 'identity.callback' | 'identity.signOut' | 'user.me' | 'activity';
+type TimebackRouteId = 'identity.signIn' | 'identity.callback' | 'identity.signOut' | 'user.me' | 'user.verify' | 'activity';
 /**
  * Normalize a path-like string to a pathname only (no query string).
  *

package/dist/server/adapters/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/server/adapters/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C;;GAEG;AACH,KAAK,WAAW,GAAG,QAAQ,GAAG,oBAAoB,CAAA;AAElD;;GAEG;AACH,KAAK,eAAe,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,SAAS,GACT,UAAU,CAAA;AAEb;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqBtD;AA8BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,eAAe,GAAG,IAAI,CAsDzB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,IAAI,QAAQ,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,IAAI,QAAQ,CAE1E"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/server/adapters/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C;;GAEG;AACH,KAAK,WAAW,GAAG,QAAQ,GAAG,oBAAoB,CAAA;AAElD;;GAEG;AACH,KAAK,eAAe,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,SAAS,GACT,aAAa,GACb,UAAU,CAAA;AAEb;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqBtD;AA8BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,eAAe,GAAG,IAAI,CAwDzB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,IAAI,QAAQ,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,IAAI,QAAQ,CAE1E"}

package/dist/server/{lib/build-activity-events.d.ts → handlers/activity/caliper.d.ts}

@@ -1,7 +1,13 @@
 import type { ActivityCompletedEvent, TimebackActivityContext, TimebackActivityMetric, TimeSpentEvent, TimeSpentMetric } from '@timeback/caliper';
 import type { TimebackClient } from '@timeback/core';
-import type { ActivityEndPayload, ActivityMetrics } from '../../shared/types';
-import type { AppConfig } from '../types';
+import type { ActivityCourseRef, ActivityMetrics } from '../../../shared/types';
+import type { ActivityBeforeSendData, AppConfig } from '../../types';
+import type { ValidatedActivityPayload } from './types';
+/**
+ * Activity Caliper Events
+ *
+ * Build and send Caliper events for activity submissions.
+ */
 /**
  * Error thrown when a course is missing a synced ID for the target environment.
  */
@@ -39,7 +45,11 @@ export declare class InvalidSensorUrlError extends Error {
  * @param sensor - Sensor URL for building the canonical activity URL
  * @returns Caliper activity context payload
  */
-export declare function buildActivityContext(payload: ActivityEndPayload, course: AppConfig['courses'][number], appName: string, apiEnv: 'staging' | 'production', sensor: string): TimebackActivityContext;
+export declare function buildActivityContext(payload: {
+    id: string;
+    name: string;
+    course: ActivityCourseRef;
+}, course: AppConfig['courses'][number], appName: string, apiEnv: 'staging' | 'production', sensor: string): TimebackActivityContext;
 /**
  * Build Caliper activity metrics from the client payload.
  *
@@ -55,6 +65,21 @@ export declare function buildActivityMetrics(metrics: ActivityMetrics): Timeback
  * @returns Normalized Caliper time spent metrics
  */
 export declare function buildTimeSpentMetrics(elapsedMs: number, pausedMs: number): TimeSpentMetric[];
+/**
+ * Build Caliper events for an activity.
+ *
+ * @param params - Event building parameters
+ * @returns Built events and context
+ */
+export declare function buildActivityEvents(params: {
+    sensor: string;
+    timebackId: string;
+    email: string;
+    payload: ValidatedActivityPayload;
+    course: AppConfig['courses'][number];
+    appName: string;
+    apiEnv: 'staging' | 'production';
+}): ActivityBeforeSendData;
 /**
  * Send a batch of Caliper events as a single envelope.
  *
@@ -64,4 +89,4 @@ export declare function buildTimeSpentMetrics(elapsedMs: number, pausedMs: numbe
  * @param timeSpentEvent - TimeSpentEvent payload
  */
 export declare function sendCaliperEnvelope(client: TimebackClient, sensor: string, activityEvent: ActivityCompletedEvent, timeSpentEvent: TimeSpentEvent): Promise<void>;
-//# sourceMappingURL=build-activity-events.d.ts.map
+//# sourceMappingURL=caliper.d.ts.map

package/dist/server/handlers/activity/caliper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caliper.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/activity/caliper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EAEtB,cAAc,EACd,eAAe,EACf,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC/E,OAAO,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACpE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAEvD;;;;GAIG;AAMH;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACpD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAA;IAC7C,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,YAAY,CAAA;IAEtC,YAAY,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,YAAY,EAW9E;CACD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB,YAAY,MAAM,EAAE,MAAM,EAMzB;CACD;AAiHD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,EAChE,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EACpC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,GAAG,YAAY,EAChC,MAAM,EAAE,MAAM,GACZ,uBAAuB,CAmBzB;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,sBAAsB,EAAE,CAoBvF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CAQ5F;AAMD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,wBAAwB,CAAA;IACjC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAA;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,SAAS,GAAG,YAAY,CAAA;CAChC,GAAG,sBAAsB,CA4CzB;AAMD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,sBAAsB,EACrC,cAAc,EAAE,cAAc,GAC5B,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/server/handlers/activity/gradebook.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Activity Gradebook (OneRoster)
+ *
+ * Write assessment line items and results for activity submissions.
+ *
+ * Attempt semantics:
+ * - `attempt` is the primary identity (1-based) stored in `metadata.attempt`
+ * - Results are written via PUT upsert using a deterministic `sourcedId`
+ * - Retry detection: if `payload.endedAt` matches an existing result's `scoreDate` (and `metadata.endedAt`),
+ *   the same attempt number is reused to make retries idempotent
+ * - New attempt: if no matching `endedAt` is found, attempt is `max(existingAttempt) + 1`
+ *
+ * Concurrency note:
+ * - Two concurrent "new attempts" for the same (lineItem, student) can race.
+ * - We avoid silent overwrites by including `endedAt` in the result `sourcedId` so two distinct submissions
+ *   never share an identifier even if they compute the same attempt number.
+ */
+import type { TimebackClient } from '@timeback/core';
+import type { ValidatedActivityPayload } from './types';
+/**
+ * Resolve the attempt number for a gradebook result.
+ *
+ * - If an existing result has `scoreDate === endedAt` or `metadata.endedAt === endedAt`,
+ *   return its `metadata.attempt` (retry of the same attempt).
+ * - Otherwise, return `max(metadata.attempt) + 1` (new attempt).
+ *
+ * @param client - Timeback client
+ * @param lineItemId - The assessment line item sourcedId
+ * @param timebackId - The student's Timeback user sourcedId
+ * @param endedAt - The activity end timestamp from the client payload
+ * @returns The attempt number to use (1-based)
+ */
+export declare function resolveAttemptNumber(client: TimebackClient, lineItemId: string, timebackId: string, endedAt: string): Promise<number>;
+/**
+ * Write gradebook entry (assessment line item + result) for an activity.
+ *
+ * This is best-effort: if the write fails, we log and continue.
+ * Gradebook writes are only performed when both totalQuestions and correctQuestions are present.
+ *
+ * Result identity is based on attempt number:
+ * - `resultId = lineItemId:studentId:attempt-N`
+ * - Retries of the same attempt (same `endedAt`) reuse the same result ID
+ * - New attempts get an incremented attempt number
+ *
+ * @param params - Gradebook write parameters
+ */
+export declare function writeGradebookEntry(params: {
+    client: TimebackClient;
+    courseId: string;
+    activityId: string;
+    activityName: string;
+    timebackId: string;
+    payload: ValidatedActivityPayload;
+    appName: string;
+}): Promise<void>;
+//# sourceMappingURL=gradebook.d.ts.map

package/dist/server/handlers/activity/gradebook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradebook.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/activity/gradebook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAGpD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAkEvD;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAuCjB;AAyMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IACjD,MAAM,EAAE,cAAc,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,wBAAwB,CAAA;IACjC,OAAO,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDhB"}

package/dist/server/handlers/activity/handler.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Activity Handler
+ *
+ * HTTP route handler for activity submissions.
+ * Orchestrates validation, user resolution, gradebook writes, and Caliper event sending.
+ */
+import type { ActivityHandler, ActivityHandlerConfig } from './types';
+/**
+ * Create the activity POST handler.
+ *
+ * @param config - Handler configuration
+ * @returns The activity request handler
+ */
+export declare function createActivityHandler(config: ActivityHandlerConfig): ActivityHandler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/server/handlers/activity/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/activity/handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAoB,MAAM,SAAS,CAAA;AAmFvF;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAuGpF"}

package/dist/server/handlers/activity/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Activity Handler
+ *
+ * Route handler for activity tracking and submission.
+ */
+export { createActivityHandler } from './handler';
+export { buildActivityContext, buildActivityMetrics, buildTimeSpentMetrics, InvalidSensorUrlError, MissingSyncedCourseIdError, sendCaliperEnvelope, } from './caliper';
+export type { ActivityHandler, ActivityHandlerConfig, ActivityUserInfo, ValidatedActivityPayload, ValidationResult, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/handlers/activity/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/activity/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AAEjD,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,GACnB,MAAM,WAAW,CAAA;AAElB,YAAY,EACX,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,GAChB,MAAM,SAAS,CAAA"}

package/dist/server/handlers/activity/resolve.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Activity Course Resolution
+ *
+ * Resolves course selectors from activity payloads to configured courses.
+ */
+import type { ActivityCourseRef } from '../../../shared/types';
+import type { AppConfig } from '../../types';
+/**
+ * Error thrown when a course selector cannot be resolved against config.
+ */
+export declare class ActivityCourseResolutionError extends Error {
+    readonly code: 'unknown_course' | 'ambiguous_course';
+    readonly selector: ActivityCourseRef;
+    readonly count?: number;
+    constructor(code: ActivityCourseResolutionError['code'], selector: ActivityCourseRef, count?: number);
+    /**
+     * Get a human-readable description of the selector.
+     *
+     * @returns Human-readable selector description
+     */
+    get selectorDescription(): string;
+}
+/**
+ * Resolve a course config entry from an activity course selector.
+ *
+ * **Use case:** Activity handler — match the client's course selector
+ * to a configured course in `timeback.config.json`.
+ *
+ * Supports two selector modes:
+ * - **subjectGrade**: Match by `(subject, grade)`
+ * - **courseCode**: Match by `courseCode`
+ *
+ * @param courses - Configured courses from `timeback.config.json`
+ * @param courseRef - Course selector from the client payload
+ * @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];
+//# sourceMappingURL=resolve.d.ts.map

package/dist/server/handlers/activity/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/activity/resolve.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACvD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,kBAAkB,CAAA;IACpD,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IAEvB,YACC,IAAI,EAAE,6BAA6B,CAAC,MAAM,CAAC,EAC3C,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,CAAC,EAAE,MAAM,EAMd;IAED;;;;OAIG;IACH,IAAI,mBAAmB,IAAI,MAAM,CAKhC;CACD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,EAC7B,SAAS,EAAE,iBAAiB,GAC1B,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAoB9B"}

package/dist/server/handlers/activity/schema.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Activity Handler Schema
+ *
+ * Zod schemas and validation logic for activity submissions.
+ */
+import * as z from 'zod';
+import type { AppConfig, Environment } from '../../types';
+import type { ValidationResult } from './types';
+/** Zod schema for validating activity payloads. */
+export declare const activityPayloadSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    course: z.ZodUnion<readonly [z.ZodObject<{
+        subject: z.ZodEnum<{
+            FastMath: "FastMath";
+            Language: "Language";
+            Math: "Math";
+            None: "None";
+            Other: "Other";
+            Reading: "Reading";
+            Science: "Science";
+            "Social Studies": "Social Studies";
+            Vocabulary: "Vocabulary";
+            Writing: "Writing";
+        }>;
+        grade: z.ZodUnion<readonly [z.ZodLiteral<-1>, z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>, z.ZodLiteral<7>, z.ZodLiteral<8>, z.ZodLiteral<9>, z.ZodLiteral<10>, z.ZodLiteral<11>, z.ZodLiteral<12>, z.ZodLiteral<13>]>;
+    }, z.core.$strip>, z.ZodObject<{
+        code: z.ZodString;
+    }, z.core.$strip>]>;
+    startedAt: z.ZodISODateTime;
+    endedAt: z.ZodISODateTime;
+    elapsedMs: z.ZodNumber;
+    pausedMs: z.ZodNumber;
+    metrics: z.ZodObject<{
+        totalQuestions: z.ZodOptional<z.ZodNumber>;
+        correctQuestions: z.ZodOptional<z.ZodNumber>;
+        xpEarned: z.ZodOptional<z.ZodNumber>;
+        masteredUnits: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    attemptNumber: z.ZodOptional<z.ZodNumber>;
+    pctCompleteApp: z.ZodPipe<z.ZodOptional<z.ZodNumber>, z.ZodTransform<number | undefined, number | undefined>>;
+}, z.core.$strip>;
+/**
+ * Validate the activity request body and resolve config dependencies.
+ *
+ * @param body - Raw request body
+ * @param appConfig - App configuration
+ * @param env - Environment
+ * @returns Validated data or error response
+ */
+export declare function validateActivityRequest(body: unknown, appConfig: AppConfig, env: Environment): ValidationResult;
+//# sourceMappingURL=schema.d.ts.map

package/dist/server/handlers/activity/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/activity/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAUxB,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AA0C/C,mDAAmD;AACnD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAchC,CAAA;AAmBF;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,WAAW,GACd,gBAAgB,CAoElB"}

package/dist/server/handlers/activity/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Activity Handler Types
+ *
+ * Feature-local types for the activity submission flow.
+ */
+import type { ActivityCourseRef } from '../../../shared/types';
+import type { ApiCredentials, AppConfig, Environment, IdentityConfig, TimebackConfig } from '../../types';
+/** User identity info needed for activity submission. */
+export interface ActivityUserInfo {
+    email: string;
+    /** Timeback ID if already resolved (SSO mode). When present, skip lookup. */
+    timebackId?: string;
+}
+/** Validated activity payload ready for submission. */
+export interface ValidatedActivityPayload {
+    id: string;
+    name: string;
+    course: ActivityCourseRef;
+    startedAt: string;
+    endedAt: string;
+    elapsedMs: number;
+    pausedMs: number;
+    metrics: {
+        totalQuestions?: number;
+        correctQuestions?: number;
+        xpEarned?: number;
+        masteredUnits?: number;
+    };
+    attemptNumber?: number;
+    pctCompleteApp?: number;
+}
+/** Result of request validation - either valid data or an error response. */
+export type ValidationResult = {
+    ok: true;
+    payload: ValidatedActivityPayload;
+    course: AppConfig['courses'][number];
+    sensor: string;
+} | {
+    ok: false;
+    response: Response;
+};
+/** Configuration for the activity handler. */
+export interface ActivityHandlerConfig {
+    env: Environment;
+    identity: IdentityConfig;
+    appConfig: AppConfig;
+    api: ApiCredentials;
+    hooks?: TimebackConfig['hooks'];
+}
+/** Activity handler type. */
+export type ActivityHandler = (req: Request) => Promise<Response>;
+//# sourceMappingURL=types.d.ts.map

package/dist/server/handlers/activity/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/activity/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EACX,cAAc,EACd,SAAS,EACT,WAAW,EACX,cAAc,EACd,cAAc,EACd,MAAM,aAAa,CAAA;AAMpB,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAMD,uDAAuD;AACvD,MAAM,WAAW,wBAAwB;IACxC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,iBAAiB,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE;QACR,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,aAAa,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB;AAMD,6EAA6E;AAC7E,MAAM,MAAM,gBAAgB,GACzB;IACA,EAAE,EAAE,IAAI,CAAA;IACR,OAAO,EAAE,wBAAwB,CAAA;IACjC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAA;IACpC,MAAM,EAAE,MAAM,CAAA;CACb,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAA;AAMpC,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACrC,GAAG,EAAE,WAAW,CAAA;IAChB,QAAQ,EAAE,cAAc,CAAA;IACxB,SAAS,EAAE,SAAS,CAAA;IACpB,GAAG,EAAE,cAAc,CAAA;IACnB,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAA;CAC/B;AAED,6BAA6B;AAC7B,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA"}

package/dist/server/handlers/identity/handler.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Identity Handlers (full SDK)
+ *
+ * This module includes Timeback user resolution and therefore depends on Timeback API access.
+ */
+import type { IdentityHandlerParams, IdentityHandlers } from './types';
+/**
+ * Create identity route handlers (full SDK).
+ *
+ * @param params - Handler configuration
+ * @returns Identity handlers
+ */
+export declare function createIdentityHandlers<TState = unknown>(params: IdentityHandlerParams<TState>): IdentityHandlers;
+//# sourceMappingURL=handler.d.ts.map

package/dist/server/handlers/identity/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/identity/handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAEtE;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,GAAG,OAAO,EACtD,MAAM,EAAE,qBAAqB,CAAC,MAAM,CAAC,GACnC,gBAAgB,CAQlB"}

package/dist/server/handlers/identity/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Identity Handler (full SDK)
+ *
+ * Route handlers for SSO authentication with Timeback user resolution.
+ */
+export { createIdentityHandlers } from './handler';
+export type { IdentityHandlerParams, IdentityHandlers } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/handlers/identity/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/identity/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAClD,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA"}

package/dist/server/handlers/identity/oidc.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Identity OIDC Flow
+ *
+ * Sign-in, callback, and token exchange for SSO authentication.
+ * This is the full SDK version that resolves Timeback users.
+ */
+import type { Environment, IdentityConfig } from '../../types';
+import type { IdentityHandlerParams } from './types';
+/**
+ * Handle sign-in request.
+ *
+ * @param req - Incoming request
+ * @param env - Environment configuration
+ * @param identity - Identity configuration
+ * @returns Redirect response to IdP
+ */
+export declare function handleSignIn<TState>(req: Request, env: Environment, identity: IdentityConfig<TState>): Promise<Response>;
+/**
+ * Exchange code for tokens and complete SSO flow (full SDK).
+ *
+ * @param code - Authorization code
+ * @param url - Callback URL
+ * @param state - Decoded state (if provided)
+ * @param req - Incoming request
+ * @param env - Environment configuration
+ * @param identity - SSO identity configuration
+ * @param api - Timeback API provider (credentials + shared client getter)
+ * @returns Success or error response
+ */
+export declare function completeCallback<TState>(code: string, url: URL, state: TState | undefined, req: Request, env: Environment, identity: IdentityConfig<TState> & {
+    mode: 'sso';
+}, api: IdentityHandlerParams<TState>['api']): Promise<Response>;
+/**
+ * Handle callback request.
+ *
+ * @param req - Incoming request
+ * @param env - Environment configuration
+ * @param identity - Identity configuration
+ * @param api - Timeback API provider (credentials + shared client getter)
+ * @returns Response from callback handler
+ */
+export declare function handleCallback<TState>(req: Request, env: Environment, identity: IdentityConfig<TState>, api: IdentityHandlerParams<TState>['api']): Promise<Response>;
+//# sourceMappingURL=oidc.d.ts.map

package/dist/server/handlers/identity/oidc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oidc.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/identity/oidc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,OAAO,KAAK,EAA0B,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACtF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAMpD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,MAAM,EACxC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,GAC9B,OAAO,CAAC,QAAQ,CAAC,CAcnB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAC5C,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,EAClD,GAAG,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GACvC,OAAO,CAAC,QAAQ,CAAC,CA0DnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAC1C,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,EAChC,GAAG,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GACvC,OAAO,CAAC,QAAQ,CAAC,CAiBnB"}

package/dist/server/handlers/identity/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Identity Handler Types (full SDK)
+ *
+ * Feature-local types for the identity/SSO handlers.
+ */
+import type { TimebackClient } from '@timeback/core';
+import type { ApiCredentials, CallbackErrorContext, CallbackSuccessContext, Environment, IdentityConfig, SsoIdentityConfig } from '../../types';
+/** Configuration for identity handlers (full SDK). */
+export interface IdentityHandlerParams<TState = unknown> {
+    env: Environment;
+    identity: IdentityConfig<TState>;
+    api: {
+        credentials: ApiCredentials;
+        getClient: () => TimebackClient;
+    };
+}
+/** Identity handlers returned by createIdentityHandlers. */
+export interface IdentityHandlers {
+    signIn: (req: Request) => Promise<Response>;
+    callback: (req: Request) => Promise<Response>;
+    signOut: () => Response;
+}
+export type { CallbackErrorContext, CallbackSuccessContext, Environment, IdentityConfig, SsoIdentityConfig, };
+//# sourceMappingURL=types.d.ts.map

package/dist/server/handlers/identity/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/identity/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EACX,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,MAAM,aAAa,CAAA;AAEpB,sDAAsD;AACtD,MAAM,WAAW,qBAAqB,CAAC,MAAM,GAAG,OAAO;IACtD,GAAG,EAAE,WAAW,CAAA;IAChB,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;IAChC,GAAG,EAAE;QACJ,WAAW,EAAE,cAAc,CAAA;QAC3B,SAAS,EAAE,MAAM,cAAc,CAAA;KAC/B,CAAA;CACD;AAED,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC3C,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC7C,OAAO,EAAE,MAAM,QAAQ,CAAA;CACvB;AAGD,YAAY,EACX,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,EACX,cAAc,EACd,iBAAiB,GACjB,CAAA"}

package/dist/server/handlers/identity-only/handler.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Identity-Only Handlers
+ *
+ * This module is intentionally minimal and does NOT import Timeback API client code.
+ * It is safe to include in edge runtimes (e.g. Cloudflare Workers / workerd).
+ */
+import type { IdentityOnlyHandlerParams, IdentityOnlyHandlers } from './types';
+/**
+ * Create identity route handlers (identity-only mode).
+ *
+ * @param params - Handler configuration
+ * @returns Identity-only handlers
+ */
+export declare function createIdentityOnlyHandlers<TState = unknown>(params: IdentityOnlyHandlerParams<TState>): IdentityOnlyHandlers;
+//# sourceMappingURL=handler.d.ts.map

package/dist/server/handlers/identity-only/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/identity-only/handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAE9E;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,GAAG,OAAO,EAC1D,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC,GACvC,oBAAoB,CAYtB"}

package/dist/server/handlers/identity-only/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Identity-Only Handler
+ *
+ * Route handlers for SSO authentication without Timeback user resolution (edge-safe).
+ */
+export { createIdentityOnlyHandlers } from './handler';
+export type { IdentityOnlyHandlerParams, IdentityOnlyHandlers } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/handlers/identity-only/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/identity-only/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAA;AACtD,YAAY,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA"}

package/dist/server/handlers/identity-only/oidc.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Identity-Only OIDC Flow
+ *
+ * Sign-in, callback, and token exchange for SSO authentication (edge-safe).
+ * This module is intentionally minimal and does NOT import Timeback API client code.
+ */
+import type { Environment, IdentityOnlyCallbackSuccessContext, SsoIdentityConfig } from '../../types';
+/**
+ * Handle sign-in request.
+ *
+ * @param req - Incoming request
+ * @param env - Environment configuration
+ * @param identity - Identity-only SSO configuration
+ * @returns Redirect response to IdP
+ */
+export declare function handleSignIn<TState>(req: Request, env: Environment, identity: SsoIdentityConfig<TState, IdentityOnlyCallbackSuccessContext<TState>>): Promise<Response>;
+/**
+ * Handle callback request for identity-only mode.
+ *
+ * @param req - Incoming request
+ * @param env - Environment configuration
+ * @param identity - Identity-only SSO configuration
+ * @returns Response from callback handler
+ */
+export declare function handleCallback<TState>(req: Request, env: Environment, identity: SsoIdentityConfig<TState, IdentityOnlyCallbackSuccessContext<TState>>): Promise<Response>;
+//# sourceMappingURL=oidc.d.ts.map

package/dist/server/handlers/identity-only/oidc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oidc.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/identity-only/oidc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,KAAK,EACX,WAAW,EACX,kCAAkC,EAClC,iBAAiB,EACjB,MAAM,aAAa,CAAA;AAMpB;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,MAAM,EACxC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,iBAAiB,CAAC,MAAM,EAAE,kCAAkC,CAAC,MAAM,CAAC,CAAC,GAC7E,OAAO,CAAC,QAAQ,CAAC,CASnB;AA4ED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAC1C,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,iBAAiB,CAAC,MAAM,EAAE,kCAAkC,CAAC,MAAM,CAAC,CAAC,GAC7E,OAAO,CAAC,QAAQ,CAAC,CAYnB"}

package/dist/server/handlers/identity-only/types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Identity-Only Handler Types
+ *
+ * Feature-local types for identity-only SSO handlers (edge-safe).
+ */
+import type { CallbackErrorContext, Environment, IdentityOnlyCallbackSuccessContext, SsoIdentityConfig } from '../../types';
+/** Configuration for identity-only handlers. */
+export interface IdentityOnlyHandlerParams<TState = unknown> {
+    env: Environment;
+    identity: SsoIdentityConfig<TState, IdentityOnlyCallbackSuccessContext<TState>>;
+}
+/** Identity-only handlers returned by createIdentityOnlyHandlers. */
+export interface IdentityOnlyHandlers {
+    signIn: (req: Request) => Promise<Response>;
+    callback: (req: Request) => Promise<Response>;
+    signOut: () => Response;
+}
+export type { CallbackErrorContext, Environment, IdentityOnlyCallbackSuccessContext, SsoIdentityConfig, };
+//# sourceMappingURL=types.d.ts.map

package/dist/server/handlers/identity-only/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/identity-only/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,oBAAoB,EACpB,WAAW,EACX,kCAAkC,EAClC,iBAAiB,EACjB,MAAM,aAAa,CAAA;AAEpB,gDAAgD;AAChD,MAAM,WAAW,yBAAyB,CAAC,MAAM,GAAG,OAAO;IAC1D,GAAG,EAAE,WAAW,CAAA;IAChB,QAAQ,EAAE,iBAAiB,CAAC,MAAM,EAAE,kCAAkC,CAAC,MAAM,CAAC,CAAC,CAAA;CAC/E;AAED,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC3C,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC7C,OAAO,EAAE,MAAM,QAAQ,CAAA;CACvB;AAGD,YAAY,EACX,oBAAoB,EACpB,WAAW,EACX,kCAAkC,EAClC,iBAAiB,GACjB,CAAA"}

package/dist/server/handlers/index.d.ts

@@ -3,7 +3,10 @@
  *
  * Route handlers for Timeback server operations.
  */
-export { createIdentityHandlers } from './identity-full';
 export { createActivityHandler } from './activity';
-export { createUserHandler } from './user';
+export { createIdentityHandlers } from './identity';
+export { createUserHandler, createUserVerifyHandler } from './user';
+export type { ActivityHandler, ActivityHandlerConfig } from './activity';
+export type { IdentityHandlerParams, IdentityHandlers } from './identity';
+export type { UserHandler, UserHandlerConfig, UserVerifyHandler, UserVerifyHandlerConfig } from './user';
 //# sourceMappingURL=index.d.ts.map

package/dist/server/handlers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAA;AAEnE,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AACxE,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACzE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAA"}

package/dist/server/{lib/build-user-profile.d.ts → handlers/user/enrollments.d.ts}

@@ -1,4 +1,9 @@
-import type { AppConfig } from '../types';
+/**
+ * User Enrollment Utilities
+ *
+ * Helpers for processing enrollments and building profile data.
+ */
+import type { AppConfig } from '../../types';
 type EnrollmentGoals = NonNullable<AppConfig['courses'][number]['metadata']>['goals'];
 type EnrollmentLike = {
     course: {
@@ -59,4 +64,4 @@ export declare function getUtcDayRange(date: Date): {
  */
 export declare function sumXp(facts: ActivityFacts): number;
 export {};
-//# sourceMappingURL=build-user-profile.d.ts.map
+//# sourceMappingURL=enrollments.d.ts.map

package/dist/server/handlers/user/enrollments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrollments.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/user/enrollments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,KAAK,eAAe,GAAG,WAAW,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;AAErF,KAAK,cAAc,GAAG;IACrB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACrC,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,eAAe,CAAA;KAAE,CAAA;CACtC,CAAA;AAED,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,eAAe,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,CAAC,CAAA;AAEhG;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,EAC7B,MAAM,EAAE,SAAS,GAAG,YAAY,GAC9B,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAW3C;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACtC,WAAW,EAAE,cAAc,EAAE,EAC7B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,GACnD,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAUnD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACvC,WAAW,EAAE,cAAc,EAAE,GAC3B,eAAe,GAAG,SAAS,CAE7B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,CAQrE;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CASlD"}

package/dist/server/handlers/user/handler.d.ts

@@ -0,0 +1,17 @@
+/**
+ * User Handler
+ *
+ * HTTP route handler for user profile data.
+ */
+import type { UserHandler, UserHandlerConfig } from './types';
+/**
+ * Create the user profile handler.
+ *
+ * Returns the current user's profile, including identity and enriched data
+ * from the Timeback API.
+ *
+ * @param config - Handler configuration
+ * @returns The user profile request handler
+ */
+export declare function createUserHandler(config: UserHandlerConfig): UserHandler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/server/handlers/user/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/user/handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AA6C7D;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAiDxE"}

package/dist/server/handlers/user/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * User Handler
+ *
+ * Route handler for user profile data.
+ */
+export { createUserHandler } from './handler';
+export { createUserVerifyHandler } from './verify';
+export { buildUserProfile } from './profile';
+export type { ResolvedUser, UserHandler, UserHandlerConfig, UserVerifyHandler, UserVerifyHandlerConfig, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/handlers/user/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/user/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,YAAY,EACX,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,GACvB,MAAM,SAAS,CAAA"}