@timeback/sdk 0.1.6 → 0.1.8

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/handlers/activity/attempts.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Activity Attempt Resolution (for process: true)
+ *
+ * Resolves attempt numbers for Caliper ActivityEvents when using `process: true`.
+ *
+ * When `process: true` is set, timeback-api-2 creates assessment line items and results
+ * using a specific ID format. This module computes the same line item ID so the SDK can
+ * query existing results and determine the correct attempt number before sending the event.
+ *
+ * Line Item ID formula (matches timeback-api-2's handleExternalUrl):
+ *   `caliper_${sha256(objectId + "_" + courseSourcedId)}`
+ *
+ * Attempt semantics:
+ * - `attempt` is 1-based, stored in `metadata.attempt` on assessment results
+ * - Retry detection: if `endedAt` matches an existing result's `metadata.endedAt`,
+ *   the same attempt number is reused (idempotent retry)
+ * - New attempt: if no matching `endedAt` is found, attempt is `max(existingAttempt) + 1`
+ */
+import type { TimebackClient } from '@timeback/core';
+/**
+ * Compute the assessment line item sourcedId that timeback-api-2 creates for external URLs.
+ *
+ * This matches the logic in timeback-api-2's `handleExternalUrl` function:
+ * ```
+ * const idParts = [objectId, course.sourcedId].join("_")
+ * const hashedId = createHash("sha256").update(idParts).digest("hex")
+ * const sourcedId = `caliper_${hashedId}`
+ * ```
+ *
+ * @param objectId - The canonical activity URL (`object.id` in the Caliper event)
+ * @param courseSourcedId - The OneRoster course sourcedId
+ * @returns The line item sourcedId that timeback-api-2 will create
+ */
+export declare function computeCaliperLineItemId(objectId: string, courseSourcedId: string): string;
+/**
+ * Resolve the attempt number for a Caliper ActivityEvent.
+ *
+ * This queries assessment results created by timeback-api-2 to determine
+ * the correct attempt number before sending the Caliper event.
+ *
+ * - If an existing result has `endedAt` matching the payload, return its attempt (retry).
+ * - Otherwise, return `max(metadata.attempt) + 1` (new attempt).
+ *
+ * @param client - Timeback client
+ * @param lineItemId - The assessment line item sourcedId (computed via `computeCaliperLineItemId`)
+ * @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 resolveCaliperAttemptNumber(client: TimebackClient, lineItemId: string, timebackId: string, endedAt: string): Promise<number>;
+//# sourceMappingURL=attempts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attempts.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/activity/attempts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AASpD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAG1F;AAgED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,2BAA2B,CAChD,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CA4DjB"}

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

@@ -0,0 +1,133 @@
+import type { ActivityCompletedEvent, TimebackActivityContext, TimebackActivityMetric, TimeSpentEvent, TimeSpentMetric } from '@timeback/caliper';
+import type { Environment, TimebackClient } from '@timeback/core';
+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.
+ */
+export declare class MissingSyncedCourseIdError extends Error {
+    readonly course: AppConfig['courses'][number];
+    readonly env: Environment;
+    constructor(course: AppConfig['courses'][number], env: Environment);
+}
+/**
+ * Error thrown when the sensor URL is invalid.
+ */
+export declare class InvalidSensorUrlError extends Error {
+    readonly sensor: string;
+    constructor(sensor: string);
+}
+/**
+ * Build a canonical activity URL from sensor, course selector, and activity slug.
+ *
+ * The resulting URL uniquely identifies the activity and allows upstream systems
+ * to process it as an "external URL" activity without requiring pre-synced
+ * OneRoster component resources.
+ *
+ * URL structure:
+ * - Grade-based: `{sensor}/activities/{subject}/g{grade}/{slug}`
+ * - Grade-less: `{sensor}/activities/{code}/{slug}`
+ *
+ * @param sensor - Sensor URL (must be a valid absolute URL)
+ * @param selector - Course selector from activity payload
+ * @param slug - Activity slug (will be URI-encoded)
+ * @returns Canonical activity URL
+ * @throws {InvalidSensorUrlError} If sensor is not a valid absolute URL
+ *
+ * @example Grade-based
+ * ```typescript
+ * buildCanonicalActivityUrl(
+ *   'https://sensor.example.com',
+ *   { subject: 'Math', grade: 3 },
+ *   'fractions-with-like-denominators'
+ * )
+ * // => 'https://sensor.example.com/activities/Math/g3/fractions-with-like-denominators'
+ * ```
+ *
+ * @example Grade-less
+ * ```typescript
+ * buildCanonicalActivityUrl(
+ *   'https://sensor.example.com',
+ *   { code: 'CS-101' },
+ *   'intro-to-loops'
+ * )
+ * // => 'https://sensor.example.com/activities/CS-101/intro-to-loops'
+ * ```
+ */
+export declare function buildCanonicalActivityUrl(sensor: string, selector: ActivityCourseRef, slug: string): string;
+/**
+ * Build a Timeback activity context for Caliper events.
+ *
+ * Handles both grade-based and grade-less courses:
+ * - Grade-based: uses subject + grade for IDs
+ * - Grade-less: uses code for IDs
+ *
+ * The `id` field (`object.id` in Caliper) is a canonical URL derived from the
+ * sensor, course selector, and activity slug. This enables upstream systems to
+ * process the activity as an "external URL" activity without requiring
+ * pre-synced OneRoster component resources.
+ *
+ * The `activity` field contains only the human-readable `name` (no `id`),
+ * since the canonical URL in `object.id` serves as the stable identifier.
+ *
+ * @param payload - Validated activity payload
+ * @param course - Matched course config
+ * @param appName - Timeback app display name
+ * @param apiEnv - Target Timeback API environment
+ * @param sensor - Sensor URL for building the canonical activity URL
+ * @param onerosterBaseUrl - OneRoster API base URL for building course URL
+ * @returns Caliper activity context payload
+ */
+export declare function buildActivityContext(payload: {
+    id: string;
+    name: string;
+    course: ActivityCourseRef;
+}, course: AppConfig['courses'][number], appName: string, apiEnv: Environment, sensor: string, onerosterBaseUrl: string): TimebackActivityContext;
+/**
+ * Build Caliper activity metrics from the client payload.
+ *
+ * @param metrics - Activity metrics from the client
+ * @returns Normalized Caliper activity metrics
+ */
+export declare function buildActivityMetrics(metrics: ActivityMetrics): TimebackActivityMetric[];
+/**
+ * Build Caliper time spent metrics from elapsed and paused times.
+ *
+ * @param elapsedMs - Active time in milliseconds
+ * @param pausedMs - Paused time in milliseconds
+ * @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: Environment;
+    onerosterBaseUrl: string;
+    attempt?: number;
+}): ActivityBeforeSendData;
+/**
+ * Send a batch of Caliper events as a single envelope.
+ *
+ * @param client - Timeback API client
+ * @param sensor - Caliper sensor URL
+ * @param activityEvent - ActivityEvent payload
+ * @param timeSpentEvent - TimeSpentEvent payload
+ */
+export declare function sendCaliperEnvelope(client: TimebackClient, sensor: string, activityEvent: ActivityCompletedEvent, timeSpentEvent: TimeSpentEvent): Promise<void>;
+//# 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,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACjE,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,WAAW,CAAA;IAEzB,YAAY,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,WAAW,EAWjE;CACD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB,YAAY,MAAM,EAAE,MAAM,EAMzB;CACD;AAuGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,MAAM,GACV,MAAM,CAoBR;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;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,WAAW,EACnB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,GACtB,uBAAuB,CAuBzB;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;AA2DD;;;;;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,WAAW,CAAA;IACnB,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB,GAAG,sBAAsB,CAkDzB;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/completion.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Mastery Completion Entry
+ *
+ * Creates a special "mastery-completion" line item + result when course mastery is achieved.
+ * This line item IS connected to `componentResource`, which triggers course completion
+ * on dashboards — unlike regular activity line items which intentionally omit the link
+ * to prevent premature completion.
+ *
+ * @see Playcademy's MasteryTracker.createCompletionEntry for the original pattern
+ */
+import type { TimebackClient } from '@timeback/core';
+/**
+ * Parameters for maybeWriteCompletionEntry.
+ */
+interface CompletionEntryParams {
+    /** Timeback client instance */
+    client: TimebackClient;
+    /** Course sourcedId (synced from config) */
+    courseId: string;
+    /** Student's Timeback user ID */
+    timebackId: string;
+    /** Computed percentage complete (0-100) */
+    pctComplete: number | undefined;
+    /** Application name for metadata */
+    appName: string;
+}
+/**
+ * Create a mastery completion entry if the student has achieved 100% completion.
+ *
+ * This is a workaround for OneRoster/dashboard completion detection:
+ * - Regular line items are NOT connected to the component resource
+ *   (to prevent the first fully-graded result from marking the course complete)
+ * - This special "mastery-completion" line item IS connected to the component resource
+ * - When mastery is achieved (pctComplete === 100), we create this line item + a fully graded result
+ * - This triggers course completion while allowing XP to aggregate normally
+ *
+ * XXX: errors are logged but do not fail the overall request.
+ *
+ * @param params - Completion entry parameters
+ */
+export declare function maybeWriteCompletionEntry(params: CompletionEntryParams): Promise<void>;
+export {};
+//# sourceMappingURL=completion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/activity/completion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAIpD;;GAEG;AACH,UAAU,qBAAqB;IAC9B,+BAA+B;IAC/B,MAAM,EAAE,cAAc,CAAA;IACtB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAA;IAChB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmF5F"}

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

@@ -0,0 +1,32 @@
+/**
+ * Activity Handler
+ *
+ * HTTP route handler for activity submissions.
+ * Orchestrates validation, user resolution, gradebook writes, and Caliper event sending.
+ */
+import { maybeWriteCompletionEntry as maybeWriteCompletionEntryImpl } from './completion';
+import { computeProgress as computeProgressImpl } from './progress';
+import type { ActivityHandler, ActivityHandlerConfig } from './types';
+/**
+ * Internal dependencies for handler.
+ *
+ * This interface enables unit tests to inject mock implementations of
+ * computeProgress and maybeWriteCompletionEntry without mocking the entire
+ * TimebackClient.
+ *
+ * Not part of the public API - only exposed for testing purposes.
+ */
+interface ActivityHandlerDeps {
+    computeProgress: typeof computeProgressImpl;
+    maybeWriteCompletionEntry: typeof maybeWriteCompletionEntryImpl;
+}
+/**
+ * Create the activity POST handler.
+ *
+ * @param config - Handler configuration
+ * @param deps - Internal dependencies (for testing only, not part of public API)
+ * @returns The activity request handler
+ */
+export declare function createActivityHandler(config: ActivityHandlerConfig, deps?: ActivityHandlerDeps): ActivityHandler;
+export {};
+//# 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;AAoBH,OAAO,EAAE,yBAAyB,IAAI,6BAA6B,EAAE,MAAM,cAAc,CAAA;AACzF,OAAO,EAAE,eAAe,IAAI,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAKnE,OAAO,KAAK,EACX,eAAe,EACf,qBAAqB,EAGrB,MAAM,SAAS,CAAA;AAQhB;;;;;;;;GAQG;AACH,UAAU,mBAAmB;IAC5B,eAAe,EAAE,OAAO,mBAAmB,CAAA;IAC3C,yBAAyB,EAAE,OAAO,6BAA6B,CAAA;CAC/D;AA+HD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,qBAAqB,EAC7B,IAAI,GAAE,mBAAiC,GACrC,eAAe,CAuLjB"}

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/progress.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Activity Progress Computation
+ *
+ * Computes `pctComplete` by aggregating historical mastered units from EduBridge
+ * enrollment analytics and combining with the current submission's mastered units.
+ */
+import type { TimebackClient } from '@timeback/core';
+import type { AppConfig, Environment } from '../../types';
+import type { ValidatedActivityPayload } from './types';
+/**
+ * Result of progress computation.
+ */
+interface ProgressResult {
+    /** Computed percentage (0-100) */
+    pctComplete: number;
+}
+/**
+ * Resolve the total lessons denominator from course config.
+ *
+ * Checks env-specific overrides first, then falls back to base metadata.
+ *
+ * @param course - Course config
+ * @param env - Target environment
+ * @returns Total lessons count, or undefined if not configured
+ */
+export declare function resolveTotalLessons(course: AppConfig['courses'][number], env: Environment): number | undefined;
+/**
+ * Compute pctComplete for an activity submission.
+ *
+ * Only computes when:
+ * - `totalLessons` is configured (> 0) for the course
+ * - `metrics.masteredUnits` is present and > 0 in the payload
+ * - `pctComplete` is not already provided by the client
+ *
+ * @param params - Computation parameters
+ * @returns Progress result with pctComplete, or undefined if conditions not met
+ */
+export declare function computeProgress(params: {
+    client: TimebackClient;
+    courseId: string;
+    timebackId: string;
+    payload: ValidatedActivityPayload;
+    course: AppConfig['courses'][number];
+    env: Environment;
+}): Promise<ProgressResult | undefined>;
+export {};
+//# sourceMappingURL=progress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/activity/progress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAIvD;;GAEG;AACH,UAAU,cAAc;IACvB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EACpC,GAAG,EAAE,WAAW,GACd,MAAM,GAAG,SAAS,CAMpB;AAcD;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC7C,MAAM,EAAE,cAAc,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,wBAAwB,CAAA;IACjC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAA;IACpC,GAAG,EAAE,WAAW,CAAA;CAChB,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAkLtC"}

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,51 @@
+/**
+ * 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>;
+    pctComplete: 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;AAWxB,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AA0E/C,mDAAmD;AACnD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAahC,CAAA;AAmBF;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,WAAW,GACd,gBAAgB,CAiHlB"}

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

@@ -0,0 +1,51 @@
+/**
+ * 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;
+    };
+    pctComplete?: 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,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB;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"}