@timeback/core 0.1.7-beta.20260309215937 → 0.1.7-beta.20260311174536

package/dist/{chunk-rjcapq41.js → chunk-858qz9cb.js}

@@ -6,5 +6,6 @@ var CALIPER_ENV_VARS = {
   clientSecret: ["TIMEBACK_API_CLIENT_SECRET", "TIMEBACK_CLIENT_SECRET", "CALIPER_CLIENT_SECRET"]
 };
 var CALIPER_DATA_VERSION = "http://purl.imsglobal.org/ctx/caliper/v1p2";
+var QUESTION_RESULT_SCORE_TYPE = "QUESTION_RESULT";
 
-export { CALIPER_ENV_VARS, CALIPER_DATA_VERSION };
+export { CALIPER_ENV_VARS, CALIPER_DATA_VERSION, QUESTION_RESULT_SCORE_TYPE };

package/dist/{chunk-5g1cbkry.js → chunk-f69gqv7m.js}

@@ -7,7 +7,7 @@ import {
   validateNonEmptyString,
   validateUuid,
   validateWithSchema
-} from "./chunk-j1vhg225.js";
+} from "./chunk-k030r9e8.js";
 
 // ../edubridge/src/utils.ts
 var log = createScopedLogger("edubridge");
@@ -22,21 +22,6 @@ function normalizeUser(user) {
     enabledUser: normalizeBoolean(user.enabledUser)
   };
 }
-function normalizeDate(date) {
-  if (date === undefined) {
-    return;
-  }
-  if (date instanceof Date) {
-    return date.toISOString();
-  }
-  if (date.includes("T")) {
-    return date;
-  }
-  if (/^\d{4}-\d{2}-\d{2}$/.test(date)) {
-    return `${date}T00:00:00.000Z`;
-  }
-  return date;
-}
 function aggregateActivityMetrics(data) {
   const result = {
     totalXp: 0,
@@ -247,6 +232,7 @@ var IMSErrorResponse = z.object({
 });
 // ../../types/src/zod/caliper.ts
 import { z as z2 } from "zod/v4";
+var CaliperIri = z2.union([z2.url(), z2.string().regex(/^urn:/, "Must be a URL or URN")]);
 var TimebackUser = z2.object({
   id: z2.url(),
   type: z2.literal("TimebackUser"),
@@ -356,11 +342,10 @@ var CaliperProfile = z2.enum([
 ]);
 var CaliperEntity = z2.union([z2.string(), z2.record(z2.string(), z2.unknown())]);
 var CaliperActor = z2.object({
-  id: z2.url(),
+  id: CaliperIri,
   type: z2.string(),
-  extensions: z2.object({
-    email: z2.email()
-  }).loose()
+  name: z2.string().optional(),
+  extensions: z2.record(z2.string(), z2.unknown()).optional()
 }).strict();
 var CaliperEvent = z2.object({
   "@context": z2.string().optional(),
@@ -400,6 +385,57 @@ var CaliperListEventsParams = z2.object({
   actorId: z2.string().min(1).optional(),
   actorEmail: z2.email().optional()
 }).strict();
+var AssessmentItemObject = z2.object({
+  id: z2.string(),
+  name: z2.string().optional(),
+  isPartOf: CaliperEntity.optional(),
+  extensions: z2.record(z2.string(), z2.unknown()).optional()
+});
+var ResponseGenerated = z2.object({
+  id: z2.string(),
+  attempt: z2.union([z2.string(), z2.record(z2.string(), z2.unknown())]).optional(),
+  startedAtTime: IsoDateTimeString.optional(),
+  endedAtTime: IsoDateTimeString.optional(),
+  duration: z2.string().optional(),
+  extensions: z2.record(z2.string(), z2.unknown()).optional()
+});
+var ScoreGenerated = z2.object({
+  id: z2.string().optional(),
+  scoreGiven: z2.number(),
+  maxScore: z2.number().optional(),
+  attempt: z2.union([z2.string(), z2.record(z2.string(), z2.unknown())]).optional(),
+  comment: z2.string().optional(),
+  extensions: z2.record(z2.string(), z2.unknown()).optional()
+});
+var QuestionSeenInput = z2.object({
+  actor: z2.union([z2.string(), CaliperActor, TimebackUser]),
+  object: AssessmentItemObject,
+  edApp: CaliperEntity,
+  id: z2.string().optional(),
+  eventTime: IsoDateTimeString.optional(),
+  session: CaliperEntity.optional(),
+  extensions: z2.record(z2.string(), z2.unknown()).optional()
+}).strict();
+var QuestionAnsweredInput = z2.object({
+  actor: z2.union([z2.string(), CaliperActor, TimebackUser]),
+  object: AssessmentItemObject,
+  edApp: CaliperEntity,
+  generated: ResponseGenerated.optional(),
+  id: z2.string().optional(),
+  eventTime: IsoDateTimeString.optional(),
+  session: CaliperEntity.optional(),
+  extensions: z2.record(z2.string(), z2.unknown()).optional()
+}).strict();
+var QuestionGradedInput = z2.object({
+  actor: z2.union([z2.string(), CaliperActor, TimebackUser]),
+  object: z2.string(),
+  generated: ScoreGenerated,
+  edApp: CaliperEntity,
+  id: z2.string().optional(),
+  eventTime: IsoDateTimeString.optional(),
+  session: CaliperEntity.optional(),
+  extensions: z2.record(z2.string(), z2.unknown()).optional()
+}).strict();
 // ../../types/src/zod/webhooks.ts
 import { z as z3 } from "zod/v4";
 var WebhookCreateInput = z3.object({
@@ -738,6 +774,7 @@ var TimebackConfig = z6.object({
 // ../../types/src/zod/edubridge.ts
 import { z as z7 } from "zod/v4";
 var EdubridgeDateString = z7.union([IsoDateTimeString, IsoDateString]);
+var EdubridgeDateStringInput = EdubridgeDateString.transform((date) => date.includes("T") ? date : `${date}T00:00:00.000Z`);
 var EduBridgeEnrollment = z7.object({
   id: z7.string(),
   role: z7.string(),
@@ -827,18 +864,18 @@ var EdubridgeUsersListParams = z7.object({
   orgSourcedIds: z7.array(NonEmptyString2).optional()
 });
 var EdubridgeActivityParams = EmailOrStudentId.extend({
-  startDate: EdubridgeDateString,
-  endDate: EdubridgeDateString,
+  startDate: EdubridgeDateStringInput,
+  endDate: EdubridgeDateStringInput,
   timezone: z7.string().optional()
 });
 var EdubridgeWeeklyFactsParams = EmailOrStudentId.extend({
-  weekDate: EdubridgeDateString,
+  weekDate: EdubridgeDateStringInput,
   timezone: z7.string().optional()
 });
 var EdubridgeEnrollmentFactsParams = z7.object({
   enrollmentId: NonEmptyString2,
-  startDate: EdubridgeDateString.optional(),
-  endDate: EdubridgeDateString.optional(),
+  startDate: EdubridgeDateStringInput.optional(),
+  endDate: EdubridgeDateStringInput.optional(),
   timezone: z7.string().optional()
 });
 // ../../types/src/zod/masterytrack.ts
@@ -929,7 +966,7 @@ var Ref = z9.object({
   type: z9.string().optional(),
   href: z9.string().optional()
 }).strict();
-var OneRosterDateString = z9.union([IsoDateString, IsoDateTimeString]);
+var OneRosterDateString = z9.union([IsoDateString, IsoDateTimeString]).transform((date) => date.includes("T") ? date : `${date}T00:00:00Z`);
 var OneRosterUserRoleInput = z9.object({
   roleType: z9.enum(["primary", "secondary"]),
   role: OneRosterUserRole,
@@ -1015,8 +1052,8 @@ var OneRosterLineItemCreateInput = z9.object({
   class: Ref,
   school: Ref,
   category: Ref,
-  assignDate: IsoDateTimeString,
-  dueDate: IsoDateTimeString,
+  assignDate: OneRosterDateString,
+  dueDate: OneRosterDateString,
   status: Status,
   description: z9.string().optional(),
   resultValueMin: z9.number().nullable().optional(),
@@ -1029,7 +1066,7 @@ var OneRosterResultCreateInput = z9.object({
   lineItem: Ref,
   student: Ref,
   class: Ref.optional(),
-  scoreDate: IsoDateTimeString,
+  scoreDate: OneRosterDateString,
   scoreStatus: z9.enum([
     "exempt",
     "fully graded",
@@ -1098,7 +1135,7 @@ var OneRosterAssessmentResultCreateInput = z9.object({
   student: Ref,
   score: z9.number().nullable().optional(),
   textScore: z9.string().nullable().optional(),
-  scoreDate: z9.string().datetime(),
+  scoreDate: OneRosterDateString,
   scoreScale: Ref.nullable().optional(),
   scorePercentile: z9.number().nullable().optional(),
   scoreStatus: z9.enum([
@@ -1829,37 +1866,37 @@ class AnalyticsResource {
     this.transport = transport;
   }
   async getActivity(params) {
-    validateWithSchema(EdubridgeActivityParams, params, "activity params");
+    const validated = validateWithSchema(EdubridgeActivityParams, params, "activity params");
     const response = await this.transport.request(`${this.transport.paths.base}/analytics/activity`, {
       params: {
-        email: params.email,
-        studentId: params.studentId,
-        startDate: normalizeDate(params.startDate),
-        endDate: normalizeDate(params.endDate),
-        timezone: params.timezone
+        email: validated.email,
+        studentId: validated.studentId,
+        startDate: validated.startDate,
+        endDate: validated.endDate,
+        timezone: validated.timezone
       }
     });
     return response.facts;
   }
   async getWeeklyFacts(params) {
-    validateWithSchema(EdubridgeWeeklyFactsParams, params, "weekly facts params");
+    const validated = validateWithSchema(EdubridgeWeeklyFactsParams, params, "weekly facts params");
     const response = await this.transport.request(`${this.transport.paths.base}/analytics/facts/weekly`, {
       params: {
-        email: params.email,
-        studentId: params.studentId,
-        weekDate: normalizeDate(params.weekDate),
-        timezone: params.timezone
+        email: validated.email,
+        studentId: validated.studentId,
+        weekDate: validated.weekDate,
+        timezone: validated.timezone
       }
     });
     return response.facts;
   }
   async getEnrollmentFacts(params) {
-    validateWithSchema(EdubridgeEnrollmentFactsParams, params, "enrollment facts params");
-    const response = await this.transport.request(`${this.transport.paths.base}/analytics/enrollment/${encodeURIComponent(params.enrollmentId)}`, {
+    const validated = validateWithSchema(EdubridgeEnrollmentFactsParams, params, "enrollment facts params");
+    const response = await this.transport.request(`${this.transport.paths.base}/analytics/enrollment/${encodeURIComponent(validated.enrollmentId)}`, {
       params: {
-        startDate: normalizeDate(params.startDate),
-        endDate: normalizeDate(params.endDate),
-        timezone: params.timezone
+        startDate: validated.startDate,
+        endDate: validated.endDate,
+        timezone: validated.timezone
       }
     });
     return response.facts;
@@ -2086,4 +2123,4 @@ function createEdubridgeClient(registry = DEFAULT_PROVIDER_REGISTRY) {
 
 // ../edubridge/src/client.ts
 var EdubridgeClient = createEdubridgeClient();
-export { ActivityCompletedInput, TimeSpentInput, CaliperEnvelopeInput, CaliperSendEventsInput, CaliperListEventsParams, WebhookCreateInput, WebhookUpdateInput, WebhookFilterCreateInput, WebhookFilterUpdateInput, CasePackageInput, ClrCredentialInput, OneRosterUserCreateInput, OneRosterCourseCreateInput, OneRosterClassCreateInput, OneRosterEnrollmentCreateInput, OneRosterCategoryCreateInput, OneRosterLineItemCreateInput, OneRosterResultCreateInput, OneRosterScoreScaleCreateInput, OneRosterAssessmentLineItemCreateInput, OneRosterAssessmentResultCreateInput, OneRosterOrgCreateInput, OneRosterSchoolCreateInput, OneRosterAcademicSessionCreateInput, OneRosterComponentResourceCreateInput, OneRosterCourseComponentCreateInput, OneRosterEnrollInput, OneRosterAgentInput, OneRosterCredentialInput, OneRosterDemographicsCreateInput, OneRosterResourceCreateInput, OneRosterCourseStructureInput, OneRosterBulkResultsInput, PowerPathCreateExternalPlacementTestInput, PowerPathCreateExternalTestOutInput, PowerPathCreateInternalTestInput, PowerPathCreateNewAttemptInput, PowerPathFinalStudentAssessmentResponseInput, PowerPathLessonPlansCreateInput, PowerPathLessonPlanOperationsInput, PowerPathLessonPlanUpdateStudentItemResponseInput, PowerPathMakeExternalTestAssignmentInput, PowerPathPlacementResetUserPlacementInput, PowerPathResetAttemptInput, PowerPathScreeningResetSessionInput, PowerPathScreeningAssignTestInput, PowerPathTestAssignmentsCreateInput, PowerPathTestAssignmentsUpdateInput, PowerPathTestAssignmentsBulkInput, PowerPathTestAssignmentsImportInput, PowerPathTestAssignmentsListParams, PowerPathTestAssignmentsAdminParams, PowerPathUpdateStudentQuestionResponseInput, PowerPathGetAssessmentProgressParams, PowerPathGetNextQuestionParams, PowerPathGetAttemptsParams, PowerPathTestOutParams, PowerPathImportExternalTestAssignmentResultsParams, PowerPathPlacementQueryParams, PowerPathSyllabusQueryParams, QtiAssessmentItemXmlCreateInput, QtiAssessmentItemJsonCreateInput, QtiAssessmentItemCreateInput, QtiAssessmentItemUpdateInput, QtiAssessmentItemProcessResponseInput, QtiAssessmentItemRef, QtiAssessmentSection, QtiTestPart, QtiReorderItemsInput, QtiAssessmentTestMetadataUpdateInput, QtiAssessmentTestCreateInput, QtiAssessmentTestUpdateInput, QtiStimulusCreateInput, QtiStimulusUpdateInput, QtiValidateInput, QtiValidateBatchInput, QtiLessonFeedbackInput, aggregateActivityMetrics, EdubridgeClient };
+export { ActivityCompletedInput, TimeSpentInput, CaliperEnvelopeInput, CaliperSendEventsInput, CaliperListEventsParams, QuestionSeenInput, QuestionAnsweredInput, QuestionGradedInput, WebhookCreateInput, WebhookUpdateInput, WebhookFilterCreateInput, WebhookFilterUpdateInput, CasePackageInput, ClrCredentialInput, OneRosterUserCreateInput, OneRosterCourseCreateInput, OneRosterClassCreateInput, OneRosterEnrollmentCreateInput, OneRosterCategoryCreateInput, OneRosterLineItemCreateInput, OneRosterResultCreateInput, OneRosterScoreScaleCreateInput, OneRosterAssessmentLineItemCreateInput, OneRosterAssessmentResultCreateInput, OneRosterOrgCreateInput, OneRosterSchoolCreateInput, OneRosterAcademicSessionCreateInput, OneRosterComponentResourceCreateInput, OneRosterCourseComponentCreateInput, OneRosterEnrollInput, OneRosterAgentInput, OneRosterCredentialInput, OneRosterDemographicsCreateInput, OneRosterResourceCreateInput, OneRosterCourseStructureInput, OneRosterBulkResultsInput, PowerPathCreateExternalPlacementTestInput, PowerPathCreateExternalTestOutInput, PowerPathCreateInternalTestInput, PowerPathCreateNewAttemptInput, PowerPathFinalStudentAssessmentResponseInput, PowerPathLessonPlansCreateInput, PowerPathLessonPlanOperationsInput, PowerPathLessonPlanUpdateStudentItemResponseInput, PowerPathMakeExternalTestAssignmentInput, PowerPathPlacementResetUserPlacementInput, PowerPathResetAttemptInput, PowerPathScreeningResetSessionInput, PowerPathScreeningAssignTestInput, PowerPathTestAssignmentsCreateInput, PowerPathTestAssignmentsUpdateInput, PowerPathTestAssignmentsBulkInput, PowerPathTestAssignmentsImportInput, PowerPathTestAssignmentsListParams, PowerPathTestAssignmentsAdminParams, PowerPathUpdateStudentQuestionResponseInput, PowerPathGetAssessmentProgressParams, PowerPathGetNextQuestionParams, PowerPathGetAttemptsParams, PowerPathTestOutParams, PowerPathImportExternalTestAssignmentResultsParams, PowerPathPlacementQueryParams, PowerPathSyllabusQueryParams, QtiAssessmentItemXmlCreateInput, QtiAssessmentItemJsonCreateInput, QtiAssessmentItemCreateInput, QtiAssessmentItemUpdateInput, QtiAssessmentItemProcessResponseInput, QtiAssessmentItemRef, QtiAssessmentSection, QtiTestPart, QtiReorderItemsInput, QtiAssessmentTestMetadataUpdateInput, QtiAssessmentTestCreateInput, QtiAssessmentTestUpdateInput, QtiStimulusCreateInput, QtiStimulusUpdateInput, QtiValidateInput, QtiValidateBatchInput, QtiLessonFeedbackInput, aggregateActivityMetrics, EdubridgeClient };

package/dist/{chunk-j1vhg225.js → chunk-k030r9e8.js}

@@ -193,12 +193,14 @@ var LEARNWITHAI_QTI_URLS = {
 var PLATFORM_ENDPOINTS = {
   BEYOND_AI: {
     token: BEYONDAI_TOKEN_URLS,
+    tokenScope: undefined,
     api: BEYONDAI_API_URLS,
     caliper: BEYONDAI_CALIPER_URLS,
     qti: BEYONDAI_QTI_URLS
   },
   LEARNWITH_AI: {
     token: LEARNWITHAI_TOKEN_URLS,
+    tokenScope: "https://purl.imsglobal.org/spec/caliper/v1p2/scope/events.write",
     api: LEARNWITHAI_API_URLS,
     caliper: LEARNWITHAI_CALIPER_URLS,
     qti: LEARNWITHAI_QTI_URLS
@@ -582,7 +584,7 @@ class TokenManager {
         Authorization: `Basic ${credentials}`,
         "Content-Type": "application/x-www-form-urlencoded"
       },
-      body: "grant_type=client_credentials"
+      body: this.config.scope ? `grant_type=client_credentials&scope=${encodeURIComponent(this.config.scope)}` : "grant_type=client_credentials"
     });
     const duration = Math.round(performance.now() - start);
     if (!response.ok) {
@@ -646,7 +648,7 @@ var BEYONDAI_PATHS = {
 };
 var LEARNWITHAI_PATHS = {
   caliper: {
-    send: "/events/1.0/",
+    send: "/caliper/v1p2",
     validate: null,
     list: null,
     get: null,
@@ -661,7 +663,9 @@ var LEARNWITHAI_PATHS = {
   edubridge: null,
   powerpath: null,
   clr: null,
-  case: null
+  case: {
+    base: "/case/1.1"
+  }
 };
 var PLATFORM_PATHS = {
   BEYOND_AI: BEYONDAI_PATHS,
@@ -698,6 +702,7 @@ class TimebackProvider {
   timeout;
   endpoints;
   authUrl;
+  tokenScope;
   pathProfiles;
   tokenManagers = new Map;
   constructor(config) {
@@ -713,6 +718,7 @@ class TimebackProvider {
         throw new Error(`Unknown platform: ${platform}`);
       }
       this.authUrl = platformEndpoints.token[env];
+      this.tokenScope = platformEndpoints.tokenScope ?? undefined;
       this.pathProfiles = PLATFORM_PATHS[platform] ?? BEYONDAI_PATHS;
       this.endpoints = {
         oneroster: {
@@ -838,7 +844,8 @@ class TimebackProvider {
         credentials: {
           clientId: this.auth.clientId,
           clientSecret: this.auth.clientSecret
-        }
+        },
+        scope: this.tokenScope
       });
       this.tokenManagers.set(authUrl, manager);
     }
@@ -856,7 +863,8 @@ class TimebackProvider {
         credentials: {
           clientId: this.auth.clientId,
           clientSecret: this.auth.clientSecret
-        }
+        },
+        scope: this.tokenScope
       });
       this.tokenManagers.set(this.authUrl, manager);
     }
@@ -1540,7 +1548,7 @@ function issue(path, message) {
 function validateWithSchema(schema, data, context) {
   const result = schema.safeParse(data);
   if (result.success) {
-    return;
+    return result.data;
   }
   const issues = result.error.issues.map((errorIssue) => ({
     path: errorIssue.path.join(".") || "(root)",

package/dist/errors.js

@@ -4,7 +4,7 @@ import {
   NotFoundError,
   UnauthorizedError,
   ValidationError
-} from "./chunk-j1vhg225.js";
+} from "./chunk-k030r9e8.js";
 import"./chunk-3j7jywnx.js";
 export {
   ValidationError,

package/dist/index.js

@@ -72,12 +72,15 @@ import {
   QtiTestPart,
   QtiValidateBatchInput,
   QtiValidateInput,
+  QuestionAnsweredInput,
+  QuestionGradedInput,
+  QuestionSeenInput,
   TimeSpentInput,
   WebhookCreateInput,
   WebhookFilterCreateInput,
   WebhookFilterUpdateInput,
   WebhookUpdateInput
-} from "./chunk-5g1cbkry.js";
+} from "./chunk-f69gqv7m.js";
 import {
   ApiError,
   BaseTransport,
@@ -103,20 +106,153 @@ import {
   validateUuid,
   validateWithSchema,
   whereToFilter
-} from "./chunk-j1vhg225.js";
+} from "./chunk-k030r9e8.js";
 import {
   CALIPER_DATA_VERSION,
-  CALIPER_ENV_VARS
-} from "./chunk-rjcapq41.js";
+  CALIPER_ENV_VARS,
+  QUESTION_RESULT_SCORE_TYPE
+} from "./chunk-858qz9cb.js";
 import"./chunk-3j7jywnx.js";
 
-// ../caliper/src/lib/resolve.ts
-function resolveToProvider2(config, registry = DEFAULT_PROVIDER_REGISTRY) {
-  return resolveToProvider(config, CALIPER_ENV_VARS, registry);
-}
+// ../caliper/src/utils.ts
+var log = createScopedLogger("caliper");
 
+// ../caliper/src/lib/transport.ts
+class Transport extends BaseTransport {
+  paths;
+  constructor(config) {
+    super({ config, logger: log });
+    this.paths = config.paths;
+  }
+  async requestPaginated(path, options = {}) {
+    const response = await this.request(path, options);
+    const { events, pagination } = response;
+    const offset = options.params?.offset ?? 0;
+    const hasMore = offset + events.length < pagination.total;
+    return {
+      data: events,
+      hasMore,
+      total: pagination.total
+    };
+  }
+}
+// ../caliper/src/lib/pagination.ts
+class Paginator2 extends Paginator {
+  constructor(transport, path, params = {}) {
+    validateOffsetListParams(params);
+    const { max, ...requestParams } = params;
+    super({
+      fetcher: (p, opts) => transport.requestPaginated(p, opts),
+      path,
+      params: requestParams,
+      max,
+      logger: log
+    });
+  }
+}
+// ../caliper/src/lib/event-factories.ts
+function createActivityEvent(input) {
+  const eventId = input.id ?? `urn:uuid:${crypto.randomUUID()}`;
+  const metricsId = input.metricsId ?? `urn:uuid:${crypto.randomUUID()}`;
+  return {
+    "@context": CALIPER_DATA_VERSION,
+    id: eventId,
+    type: "ActivityEvent",
+    action: "Completed",
+    actor: input.actor,
+    object: input.object,
+    eventTime: input.eventTime ?? new Date().toISOString(),
+    profile: "TimebackProfile",
+    generated: {
+      id: metricsId,
+      type: "TimebackActivityMetricsCollection",
+      items: input.metrics,
+      ...input.attempt === undefined ? {} : { attempt: input.attempt },
+      ...input.generatedExtensions ? { extensions: input.generatedExtensions } : {}
+    },
+    extensions: input.extensions,
+    ...input.edApp === undefined ? {} : { edApp: input.edApp },
+    ...input.session === undefined ? {} : { session: input.session }
+  };
+}
+function createTimeSpentEvent(input) {
+  const eventId = input.id ?? `urn:uuid:${crypto.randomUUID()}`;
+  const metricsId = input.metricsId ?? `urn:uuid:${crypto.randomUUID()}`;
+  return {
+    "@context": CALIPER_DATA_VERSION,
+    id: eventId,
+    type: "TimeSpentEvent",
+    action: "SpentTime",
+    actor: input.actor,
+    object: input.object,
+    eventTime: input.eventTime ?? new Date().toISOString(),
+    profile: "TimebackProfile",
+    generated: {
+      id: metricsId,
+      type: "TimebackTimeSpentMetricsCollection",
+      items: input.metrics
+    },
+    extensions: input.extensions,
+    ...input.edApp === undefined ? {} : { edApp: input.edApp },
+    ...input.session === undefined ? {} : { session: input.session }
+  };
+}
+function createQuestionSeenEvent(input) {
+  return {
+    "@context": CALIPER_DATA_VERSION,
+    id: input.id ?? `urn:uuid:${crypto.randomUUID()}`,
+    type: "AssessmentItemEvent",
+    action: "Started",
+    profile: "AssessmentProfile",
+    actor: input.actor,
+    object: { ...input.object, type: "AssessmentItem" },
+    eventTime: input.eventTime ?? new Date().toISOString(),
+    edApp: input.edApp,
+    ...input.session === undefined ? {} : { session: input.session },
+    ...input.extensions === undefined ? {} : { extensions: input.extensions }
+  };
+}
+function createQuestionAnsweredEvent(input) {
+  return {
+    "@context": CALIPER_DATA_VERSION,
+    id: input.id ?? `urn:uuid:${crypto.randomUUID()}`,
+    type: "AssessmentItemEvent",
+    action: "Completed",
+    profile: "AssessmentProfile",
+    actor: input.actor,
+    object: { ...input.object, type: "AssessmentItem" },
+    eventTime: input.eventTime ?? new Date().toISOString(),
+    edApp: input.edApp,
+    ...input.generated === undefined ? {} : { generated: { ...input.generated, type: "Response" } },
+    ...input.session === undefined ? {} : { session: input.session },
+    ...input.extensions === undefined ? {} : { extensions: input.extensions }
+  };
+}
+function createQuestionGradedEvent(input) {
+  const { id: scoreId, ...scoreRest } = input.generated;
+  return {
+    "@context": CALIPER_DATA_VERSION,
+    id: input.id ?? `urn:uuid:${crypto.randomUUID()}`,
+    type: "GradeEvent",
+    action: "Graded",
+    profile: "GradingProfile",
+    actor: input.actor,
+    object: input.object,
+    eventTime: input.eventTime ?? new Date().toISOString(),
+    edApp: input.edApp,
+    generated: {
+      ...scoreRest,
+      id: scoreId ?? `urn:uuid:${crypto.randomUUID()}`,
+      type: "Score",
+      scoreType: QUESTION_RESULT_SCORE_TYPE
+    },
+    ...input.session === undefined ? {} : { session: input.session },
+    ...input.extensions === undefined ? {} : { extensions: input.extensions }
+  };
+}
 // ../caliper/src/lib/lwai-event-transformer.ts
 var CALIPER_CONTEXT = "http://purl.imsglobal.org/ctx/caliper/v1p2";
+var SESSION_AUTO_ATTACH = "urn:tag:auto-attach";
 var CALIPER_TYPE = {
   PERSON: "Person",
   ASSIGNABLE_DIGITAL_RESOURCE: "AssignableDigitalResource",
@@ -151,7 +287,7 @@ function transformEvent(event) {
   if (transformed.profile === "TimebackProfile") {
     transformed.profile = "AggregationProfile";
   }
-  if (isDict(transformed.actor)) {
+  if (isDict(transformed.actor) && transformed.actor.type === "TimebackUser") {
     transformed.actor = transformActor(transformed.actor);
   }
   if (isDict(transformed.object)) {
@@ -165,6 +301,9 @@ function transformEvent(event) {
       transformed.generated = transformTimeSpentMetrics(transformed.generated);
     }
   }
+  if (!transformed.session) {
+    transformed.session = SESSION_AUTO_ATTACH;
+  }
   return transformed;
 }
 function transformActor(actor) {
@@ -234,91 +373,9 @@ function transformTimeSpentMetrics(collection) {
 function isDict(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-
-// ../caliper/src/utils.ts
-var log = createScopedLogger("caliper");
-
-// ../caliper/src/lib/transport.ts
-class Transport extends BaseTransport {
-  paths;
-  constructor(config) {
-    super({ config, logger: log });
-    this.paths = config.paths;
-  }
-  async requestPaginated(path, options = {}) {
-    const response = await this.request(path, options);
-    const { events, pagination } = response;
-    const offset = options.params?.offset ?? 0;
-    const hasMore = offset + events.length < pagination.total;
-    return {
-      data: events,
-      hasMore,
-      total: pagination.total
-    };
-  }
-}
-
-// ../caliper/src/lib/event-factories.ts
-function createActivityEvent(input) {
-  const eventId = input.id ?? `urn:uuid:${crypto.randomUUID()}`;
-  const metricsId = input.metricsId ?? `urn:uuid:${crypto.randomUUID()}`;
-  return {
-    "@context": CALIPER_DATA_VERSION,
-    id: eventId,
-    type: "ActivityEvent",
-    action: "Completed",
-    actor: input.actor,
-    object: input.object,
-    eventTime: input.eventTime ?? new Date().toISOString(),
-    profile: "TimebackProfile",
-    generated: {
-      id: metricsId,
-      type: "TimebackActivityMetricsCollection",
-      items: input.metrics,
-      ...input.attempt === undefined ? {} : { attempt: input.attempt },
-      ...input.generatedExtensions ? { extensions: input.generatedExtensions } : {}
-    },
-    extensions: input.extensions,
-    ...input.edApp === undefined ? {} : { edApp: input.edApp },
-    ...input.session === undefined ? {} : { session: input.session }
-  };
-}
-function createTimeSpentEvent(input) {
-  const eventId = input.id ?? `urn:uuid:${crypto.randomUUID()}`;
-  const metricsId = input.metricsId ?? `urn:uuid:${crypto.randomUUID()}`;
-  return {
-    "@context": CALIPER_DATA_VERSION,
-    id: eventId,
-    type: "TimeSpentEvent",
-    action: "SpentTime",
-    actor: input.actor,
-    object: input.object,
-    eventTime: input.eventTime ?? new Date().toISOString(),
-    profile: "TimebackProfile",
-    generated: {
-      id: metricsId,
-      type: "TimebackTimeSpentMetricsCollection",
-      items: input.metrics
-    },
-    extensions: input.extensions,
-    ...input.edApp === undefined ? {} : { edApp: input.edApp },
-    ...input.session === undefined ? {} : { session: input.session }
-  };
-}
-
-// ../caliper/src/lib/pagination.ts
-class Paginator2 extends Paginator {
-  constructor(transport, path, params = {}) {
-    validateOffsetListParams(params);
-    const { max, ...requestParams } = params;
-    super({
-      fetcher: (p, opts) => transport.requestPaginated(p, opts),
-      path,
-      params: requestParams,
-      max,
-      logger: log
-    });
-  }
+// ../caliper/src/lib/resolve.ts
+function resolveToProvider2(config, registry = DEFAULT_PROVIDER_REGISTRY) {
+  return resolveToProvider(config, CALIPER_ENV_VARS, registry);
 }
 
 // ../caliper/src/resources/events.ts
@@ -347,8 +404,9 @@ class EventsResource {
     });
     const body = this.eventTransformer ? this.eventTransformer.transformEnvelope(envelope) : envelope;
     const response = await this.transport.request(this.transport.paths.send, { method: "POST", body });
-    log.debug("Events queued for processing", { jobId: response.jobId });
-    return { jobId: response.jobId };
+    const jobId = response?.jobId;
+    log.debug("Events sent", { jobId: jobId ?? "(none)" });
+    return { jobId };
   }
   async validate(envelope) {
     const validatePath = this.transport.paths.validate;
@@ -461,6 +519,37 @@ class EventsResource {
     });
     return this.send(sensor, [event]);
   }
+  sendQuestionSeen(sensor, input) {
+    validateWithSchema(QuestionSeenInput, input, "question seen event");
+    const event = createQuestionSeenEvent(input);
+    log.debug("Sending AssessmentItemEvent.Started", {
+      eventId: event.id,
+      actor: input.actor,
+      object: input.object.id
+    });
+    return this.send(sensor, [event]);
+  }
+  sendQuestionAnswered(sensor, input) {
+    validateWithSchema(QuestionAnsweredInput, input, "question answered event");
+    const event = createQuestionAnsweredEvent(input);
+    log.debug("Sending AssessmentItemEvent.Completed", {
+      eventId: event.id,
+      actor: input.actor,
+      object: input.object.id
+    });
+    return this.send(sensor, [event]);
+  }
+  sendQuestionGraded(sensor, input) {
+    validateWithSchema(QuestionGradedInput, input, "question graded event");
+    const event = createQuestionGradedEvent(input);
+    log.debug("Sending GradeEvent.Graded", {
+      eventId: event.id,
+      actor: input.actor,
+      object: input.object,
+      scoreGiven: input.generated.scoreGiven
+    });
+    return this.send(sensor, [event]);
+  }
 }
 // ../caliper/src/resources/jobs.ts
 class JobsResource {
@@ -964,10 +1053,8 @@ class BaseResource {
   }
   create(data) {
     const schema = this.createSchema;
-    if (schema) {
-      validateWithSchema(schema, data, this.resourceName);
-    }
-    const body = this.wrapBody(data);
+    const validated = schema ? validateWithSchema(schema, data, this.resourceName) : data;
+    const body = this.wrapBody(validated);
     return this.transport.request(this.basePath, {
       method: "POST",
       body
@@ -993,10 +1080,8 @@ class BaseResource {
   }
   async sendUpdate(sourcedId, data) {
     const schema = this.updateSchema;
-    if (schema) {
-      validateWithSchema(schema, data, `update ${this.resourceName}`);
-    }
-    const body = this.wrapBody(data);
+    const validated = schema ? validateWithSchema(schema, data, `update ${this.resourceName}`) : data;
+    const body = this.wrapBody(validated);
     await this.transport.request(`${this.basePath}/${sourcedId}`, {
       method: "PUT",
       body
@@ -1005,10 +1090,8 @@ class BaseResource {
   }
   async sendUpdateAndReturn(sourcedId, data) {
     const schema = this.updateSchema;
-    if (schema) {
-      validateWithSchema(schema, data, `update ${this.resourceName}`);
-    }
-    const body = this.wrapBody(data);
+    const validated = schema ? validateWithSchema(schema, data, `update ${this.resourceName}`) : data;
+    const body = this.wrapBody(validated);
     const response = await this.transport.request(`${this.basePath}/${sourcedId}`, {
       method: "PUT",
       body
@@ -1861,10 +1944,10 @@ class ScopedSchoolResource {
     return new Paginator3(this.transport, `${this.gradebookPath}/lineItems`, params, "lineItems");
   }
   createLineItem(data) {
-    validateWithSchema(OneRosterLineItemCreateInput, data, "line item");
+    const validated = validateWithSchema(OneRosterLineItemCreateInput, data, "line item");
     return this.transport.request(`${this.gradebookPath}/lineItems`, {
       method: "POST",
-      body: { lineItems: [data] }
+      body: { lineItems: [validated] }
     });
   }
   scoreScales(params) {
@@ -1918,10 +2001,10 @@ class ScopedClassAcademicSessionResource {
     this.gradebookPath = `${transport.paths.gradebook}/classes/${classId}/academicSessions/${sessionId}`;
   }
   createResult(result) {
-    validateWithSchema(OneRosterResultCreateInput, result, "result");
+    const validated = validateWithSchema(OneRosterResultCreateInput, result, "result");
     return this.transport.request(`${this.gradebookPath}/results`, {
       method: "POST",
-      body: { results: [result] }
+      body: { results: [validated] }
     });
   }
 }
@@ -2013,10 +2096,10 @@ class ScopedClassResource {
     return new Paginator3(this.transport, `${this.gradebookPath}/lineItems`, params, "lineItems");
   }
   createLineItem(data) {
-    validateWithSchema(OneRosterLineItemCreateInput, data, "line item");
+    const validated = validateWithSchema(OneRosterLineItemCreateInput, data, "line item");
     return this.transport.request(`${this.gradebookPath}/lineItems`, {
       method: "POST",
-      body: { lineItems: [data] }
+      body: { lineItems: [validated] }
     });
   }
   results(params) {
@@ -2347,10 +2430,10 @@ class ScopedTermResource {
     return new Paginator3(this.transport, `${this.basePath}/gradingPeriods`, params, "gradingPeriods");
   }
   createGradingPeriod(data) {
-    validateWithSchema(OneRosterAcademicSessionCreateInput, data, "grading period");
+    const validated = validateWithSchema(OneRosterAcademicSessionCreateInput, data, "grading period");
     return this.transport.request(`${this.basePath}/gradingPeriods`, {
       method: "POST",
-      body: { academicSession: data }
+      body: { academicSession: validated }
     });
   }
 }

package/dist/types.js

@@ -1,6 +1,6 @@
 import {
   CALIPER_DATA_VERSION
-} from "./chunk-rjcapq41.js";
+} from "./chunk-858qz9cb.js";
 import {
   __export
 } from "./chunk-3j7jywnx.js";

package/dist/utils.js

@@ -1,7 +1,7 @@
 import {
   aggregateActivityMetrics
-} from "./chunk-5g1cbkry.js";
-import"./chunk-j1vhg225.js";
+} from "./chunk-f69gqv7m.js";
+import"./chunk-k030r9e8.js";
 import"./chunk-3j7jywnx.js";
 export {
   aggregateActivityMetrics

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@timeback/core",
-	"version": "0.1.7-beta.20260309215937",
+	"version": "0.1.7-beta.20260311174536",
 	"type": "module",
 	"exports": {
 		".": {