@conform-ed/contracts 0.0.3

package/src/xapi/v1_0_3/index.ts

@@ -0,0 +1,169 @@
+export * from "../shared";
+
+import {
+  ActivitiesResourceQuerySchema,
+  AboutResourceSchema,
+  ActivityProfileDocumentListingQuerySchema,
+  ActivityProfileDocumentQuerySchema,
+  ActivitySchema,
+  AgentAccountSchema,
+  AgentsResourceQuerySchema,
+  AgentProfileDocumentListingQuerySchema,
+  AgentProfileDocumentQuerySchema,
+  AgentSchema,
+  AttachmentSchema,
+  ContextActivitiesSchema,
+  ContextSchema,
+  GroupSchema,
+  InteractionComponentSchema,
+  InteractionTypeSchema,
+  Iso8601DurationSchema,
+  Iso8601TimestampSchema,
+  LanguageMapSchema,
+  LanguageTagSchema,
+  NonEmptyStringSchema,
+  PersonSchema,
+  ResultSchema,
+  ScoreSchema,
+  StatementsQuerySchema,
+  StatementObjectSchema,
+  StatementResultSchema,
+  StatementRefSchema,
+  StatementSchema,
+  StatementSubmissionSchema,
+  StateDocumentListingQuerySchema,
+  StateDocumentQuerySchema,
+  SubStatementSchema,
+  UuidSchema,
+  VerbSchema,
+  XapiDocumentSchema,
+  XapiDocumentIdListSchema,
+  IriSchema,
+  XapiVersionSchema,
+  XapiHttpMethodSchema,
+  XapiResourceSchema,
+  XapiRequestHeaderSchema,
+  XapiResponseHeaderSchema,
+  XapiErrorCodeSchema,
+  XapiErrorResponseSchema,
+  XapiConcurrencySchema,
+  XapiMultipartAttachmentPartSchema,
+  XapiMultipartRequestSchema,
+} from "../shared";
+
+export namespace XapiV1_0_3 {
+  export namespace Schemas {
+    export const AgentAccount = AgentAccountSchema;
+    export const Agent = AgentSchema;
+    export const Group = GroupSchema;
+    export const Verb = VerbSchema;
+    export const InteractionComponent = InteractionComponentSchema;
+    export const Activity = ActivitySchema;
+    export const StatementRef = StatementRefSchema;
+    export const SubStatement = SubStatementSchema;
+    export const Score = ScoreSchema;
+    export const Result = ResultSchema;
+    export const ContextActivities = ContextActivitiesSchema;
+    export const Context = ContextSchema;
+    export const Attachment = AttachmentSchema;
+    export const StatementObject = StatementObjectSchema;
+    export const Statement = StatementSchema;
+    export const StatementSubmission = StatementSubmissionSchema;
+    export const StatementResult = StatementResultSchema;
+    export const Person = PersonSchema;
+    export const AboutResource = AboutResourceSchema;
+    export const StatementsQuery = StatementsQuerySchema;
+    export const AgentsResourceQuery = AgentsResourceQuerySchema;
+    export const ActivitiesResourceQuery = ActivitiesResourceQuerySchema;
+    export const StateDocumentQuery = StateDocumentQuerySchema;
+    export const StateDocumentListingQuery = StateDocumentListingQuerySchema;
+    export const AgentProfileDocumentQuery = AgentProfileDocumentQuerySchema;
+    export const AgentProfileDocumentListingQuery = AgentProfileDocumentListingQuerySchema;
+    export const ActivityProfileDocumentQuery = ActivityProfileDocumentQuerySchema;
+    export const ActivityProfileDocumentListingQuery = ActivityProfileDocumentListingQuerySchema;
+    export const XapiDocument = XapiDocumentSchema;
+    export const XapiDocumentIdList = XapiDocumentIdListSchema;
+    export const HttpMethod = XapiHttpMethodSchema;
+    export const Resource = XapiResourceSchema;
+    export const RequestHeader = XapiRequestHeaderSchema;
+    export const ResponseHeader = XapiResponseHeaderSchema;
+    export const ErrorCode = XapiErrorCodeSchema;
+    export const ErrorResponse = XapiErrorResponseSchema;
+    export const Concurrency = XapiConcurrencySchema;
+    export const MultipartAttachmentPart = XapiMultipartAttachmentPartSchema;
+    export const MultipartRequest = XapiMultipartRequestSchema;
+  }
+
+  export namespace Shared {
+    export const Uuid = UuidSchema;
+    export const Version = XapiVersionSchema;
+    export const Iri = IriSchema;
+    export const LanguageTag = LanguageTagSchema;
+    export const LanguageMap = LanguageMapSchema;
+    export const Timestamp = Iso8601TimestampSchema;
+    export const Duration = Iso8601DurationSchema;
+    export const NonEmptyString = NonEmptyStringSchema;
+    export const InteractionType = InteractionTypeSchema;
+  }
+}
+
+export type XapiV1_0_3Schemas = typeof XapiV1_0_3.Schemas;
+
+export const XapiV1_0_3DerivedZodTemplates = {
+  description:
+    "xAPI 1.0.3 Zod schemas for statements, statement result/person objects, document resources, LRS transport, and about metadata",
+  specLinks: {
+    about: "https://github.com/adlnet/xAPI-Spec/blob/ca782a1129bc6ae848640ff4e8e262334bdd0ba5/xAPI-About.md",
+    data: "https://github.com/adlnet/xAPI-Spec/blob/ca782a1129bc6ae848640ff4e8e262334bdd0ba5/xAPI-Data.md",
+    communication:
+      "https://github.com/adlnet/xAPI-Spec/blob/ca782a1129bc6ae848640ff4e8e262334bdd0ba5/xAPI-Communication.md",
+    lrsContent:
+      "https://github.com/adlnet/xAPI-Spec/blob/ca782a1129bc6ae848640ff4e8e262334bdd0ba5/xAPI-Communication.md#lrs",
+  },
+  scope:
+    "Statements, statement-like objects, statement result/person objects, statement and resource queries, LRS document resources and id lists, transport headers, concurrency control, multipart attachment handling, and about/version metadata",
+  designNotes: [
+    "Structured statement data is modeled strictly; document bodies are intentionally permissive because xAPI allows arbitrary document content types.",
+    "Agent and Group validators require at least one identifier or member list, matching the data model intent rather than relying on shape alone.",
+    "The transport- and header-level parts of the spec are represented as helper schemas rather than being forced into a single statement object.",
+    "Concurrency control (ETags, If-Match/If-None-Match) and multipart attachment transmission are modeled as separate concerns for flexibility.",
+    "Error codes and response envelopes follow HTTP semantics with explicit status codes and optional detail messaging.",
+  ],
+  coreSchemas: [
+    "Agent",
+    "Group",
+    "Verb",
+    "Activity",
+    "SubStatement",
+    "Result",
+    "Context",
+    "Attachment",
+    "Statement",
+    "StatementResult",
+    "Person",
+    "AboutResource",
+    "StatementsQuery",
+    "AgentsResourceQuery",
+    "ActivitiesResourceQuery",
+    "StateDocumentQuery",
+    "StateDocumentListingQuery",
+    "AgentProfileDocumentQuery",
+    "AgentProfileDocumentListingQuery",
+    "ActivityProfileDocumentQuery",
+    "ActivityProfileDocumentListingQuery",
+    "XapiDocumentIdList",
+    "HttpMethod",
+    "Resource",
+    "RequestHeader",
+    "ResponseHeader",
+    "ErrorCode",
+    "ErrorResponse",
+    "Concurrency",
+    "MultipartAttachmentPart",
+    "MultipartRequest",
+  ],
+} as const;
+
+export const Schemas = XapiV1_0_3.Schemas;
+export const Shared = XapiV1_0_3.Shared;
+export const DerivedZodTemplates = XapiV1_0_3DerivedZodTemplates;

package/src/xapi/v2_0/index.ts

@@ -0,0 +1,256 @@
+export * from "../shared";
+
+import { z } from "zod";
+
+import {
+  strictObject,
+  ActivitiesResourceQuerySchema,
+  AboutResourceSchema,
+  ActivityProfileDocumentListingQuerySchema,
+  ActivityProfileDocumentQuerySchema,
+  ActivitySchema,
+  AgentAccountSchema,
+  AgentProfileDocumentListingQuerySchema,
+  AgentProfileDocumentQuerySchema,
+  AgentSchema,
+  AgentsResourceQuerySchema,
+  AttachmentSchema,
+  ContextActivitiesSchema,
+  ContextSchema,
+  GroupSchema,
+  InteractionComponentSchema,
+  InteractionTypeSchema,
+  IriSchema,
+  Iso8601DurationSchema,
+  Iso8601TimestampSchema,
+  LanguageMapSchema,
+  LanguageTagSchema,
+  NonEmptyStringSchema,
+  PersonSchema,
+  ResultSchema,
+  ScoreSchema,
+  StatementsQuerySchema,
+  StatementRefSchema,
+  StatementResultMoreSchema,
+  StateDocumentListingQuerySchema,
+  StateDocumentQuerySchema,
+  UuidSchema,
+  VerbSchema,
+  XapiConcurrencySchema,
+  XapiDocumentIdListSchema,
+  XapiDocumentSchema,
+  XapiErrorCodeSchema,
+  XapiErrorResponseSchema,
+  XapiHttpMethodSchema,
+  XapiMultipartAttachmentPartSchema,
+  XapiRequestHeaderSchema,
+  XapiResourceSchema,
+  XapiResponseHeaderSchema,
+  XapiVersionSchema,
+} from "../shared";
+
+export const ContextAgentSchema = strictObject({
+  objectType: z.literal("contextAgent"),
+  agent: AgentSchema,
+  relevantTypes: z.array(IriSchema).min(1).optional(),
+});
+
+export const ContextGroupSchema = strictObject({
+  objectType: z.literal("contextGroup"),
+  group: GroupSchema,
+  relevantTypes: z.array(IriSchema).min(1).optional(),
+});
+
+export const ContextV2Schema = ContextSchema.extend({
+  contextAgents: z.array(ContextAgentSchema).min(1).optional(),
+  contextGroups: z.array(ContextGroupSchema).min(1).optional(),
+});
+
+export const SubStatementV2Schema = strictObject({
+  objectType: z.literal("SubStatement"),
+  actor: z.union([AgentSchema, GroupSchema]),
+  verb: VerbSchema,
+  object: z.union([ActivitySchema, AgentSchema, GroupSchema, StatementRefSchema]),
+  result: ResultSchema.optional(),
+  context: ContextV2Schema.optional(),
+  timestamp: Iso8601TimestampSchema.optional(),
+});
+
+export const StatementObjectV2Schema = z.union([
+  ActivitySchema,
+  AgentSchema,
+  GroupSchema,
+  StatementRefSchema,
+  SubStatementV2Schema,
+]);
+
+export const StatementV2Schema = strictObject({
+  id: UuidSchema.optional(),
+  actor: z.union([AgentSchema, GroupSchema]),
+  verb: VerbSchema,
+  object: StatementObjectV2Schema,
+  result: ResultSchema.optional(),
+  context: ContextV2Schema.optional(),
+  timestamp: Iso8601TimestampSchema.optional(),
+  stored: Iso8601TimestampSchema.optional(),
+  authority: z.union([AgentSchema, GroupSchema]).optional(),
+  version: XapiVersionSchema.optional(),
+  attachments: z.array(AttachmentSchema).min(1).optional(),
+});
+
+export const StatementSubmissionV2Schema = z.union([StatementV2Schema, z.array(StatementV2Schema).min(1)]);
+
+export const StatementResultV2Schema = strictObject({
+  statements: z.array(StatementV2Schema),
+  more: StatementResultMoreSchema.optional(),
+});
+
+export const XapiMultipartRequestV2Schema = strictObject({
+  contentType: z.literal("multipart/mixed"),
+  parts: z.tuple([
+    strictObject({
+      contentType: z.literal("application/json"),
+      body: z.union([StatementV2Schema, z.array(StatementV2Schema).min(1)]),
+    }),
+    z.array(XapiMultipartAttachmentPartSchema).min(1),
+  ]),
+});
+
+export namespace XapiV2_0 {
+  export namespace Schemas {
+    export const AgentAccount = AgentAccountSchema;
+    export const Agent = AgentSchema;
+    export const Group = GroupSchema;
+    export const Person = PersonSchema;
+    export const Verb = VerbSchema;
+    export const InteractionComponent = InteractionComponentSchema;
+    export const Activity = ActivitySchema;
+    export const StatementRef = StatementRefSchema;
+    export const ContextAgent = ContextAgentSchema;
+    export const ContextGroup = ContextGroupSchema;
+    export const SubStatement = SubStatementV2Schema;
+    export const Score = ScoreSchema;
+    export const Result = ResultSchema;
+    export const ContextActivities = ContextActivitiesSchema;
+    export const Context = ContextV2Schema;
+    export const Attachment = AttachmentSchema;
+    export const StatementObject = StatementObjectV2Schema;
+    export const Statement = StatementV2Schema;
+    export const StatementSubmission = StatementSubmissionV2Schema;
+    export const StatementResult = StatementResultV2Schema;
+    export const AboutResource = AboutResourceSchema;
+    export const StatementsQuery = StatementsQuerySchema;
+    export const AgentsResourceQuery = AgentsResourceQuerySchema;
+    export const ActivitiesResourceQuery = ActivitiesResourceQuerySchema;
+    export const StateDocumentQuery = StateDocumentQuerySchema;
+    export const StateDocumentListingQuery = StateDocumentListingQuerySchema;
+    export const AgentProfileDocumentQuery = AgentProfileDocumentQuerySchema;
+    export const AgentProfileDocumentListingQuery = AgentProfileDocumentListingQuerySchema;
+    export const ActivityProfileDocumentQuery = ActivityProfileDocumentQuerySchema;
+    export const ActivityProfileDocumentListingQuery = ActivityProfileDocumentListingQuerySchema;
+    export const XapiDocument = XapiDocumentSchema;
+    export const XapiDocumentIdList = XapiDocumentIdListSchema;
+    export const HttpMethod = XapiHttpMethodSchema;
+    export const Resource = XapiResourceSchema;
+    export const RequestHeader = XapiRequestHeaderSchema;
+    export const ResponseHeader = XapiResponseHeaderSchema;
+    export const ErrorCode = XapiErrorCodeSchema;
+    export const ErrorResponse = XapiErrorResponseSchema;
+    export const Concurrency = XapiConcurrencySchema;
+    export const MultipartAttachmentPart = XapiMultipartAttachmentPartSchema;
+    export const MultipartRequest = XapiMultipartRequestV2Schema;
+  }
+
+  export namespace Shared {
+    export const Uuid = UuidSchema;
+    export const Version = XapiVersionSchema;
+    export const Iri = IriSchema;
+    export const LanguageTag = LanguageTagSchema;
+    export const LanguageMap = LanguageMapSchema;
+    export const Timestamp = Iso8601TimestampSchema;
+    export const Duration = Iso8601DurationSchema;
+    export const NonEmptyString = NonEmptyStringSchema;
+    export const InteractionType = InteractionTypeSchema;
+  }
+}
+
+export type XapiV2_0Schemas = typeof XapiV2_0.Schemas;
+
+export const XapiV2_0DerivedZodTemplates = {
+  description:
+    "IEEE xAPI 2.0 Zod schemas for statements, 2.0 context objects, statement result/person objects, document resources, LRS transport, and about metadata",
+  specLinks: {
+    overview:
+      "https://github.com/madebyraygun/xapi-base-standard-documentation/blob/134afd8c108b4d1b98294a1613db38a6b8fe73d8/9274.1.1%20xAPI%20Base%20Standard%20Overview.md",
+    content:
+      "https://github.com/madebyraygun/xapi-base-standard-documentation/blob/134afd8c108b4d1b98294a1613db38a6b8fe73d8/9274.1.1%20xAPI%20Base%20Standard%20for%20Content.md",
+    lrs: "https://github.com/madebyraygun/xapi-base-standard-documentation/blob/134afd8c108b4d1b98294a1613db38a6b8fe73d8/9274.1.1%20xAPI%20Base%20Standard%20for%20LRSs.md",
+  },
+  scope:
+    "Statements, IEEE 2.0 contextAgent/contextGroup objects, statement result/person objects, statement and resource queries, LRS document resources and id lists, transport headers, concurrency control, multipart attachment handling, and service metadata for IEEE xAPI 2.0",
+  designNotes: [
+    "The 2.0 bundle reuses the 1.0.3 data model where the standard remains structurally equivalent, but overrides Context, SubStatement, Statement, StatementSubmission, StatementResult, and multipart request schemas to capture 2.0-only contextAgent/contextGroup support.",
+    "Version-specific differences are isolated in the package boundary and documentation rather than duplicated across the shared primitives.",
+    "Transport-level concerns such as headers and concurrency are represented as companion helper schemas rather than being merged into statement data.",
+    "LRS resource and concurrency models follow HTTP semantics with ETags, conditional requests (If-Match/If-None-Match), and standard error codes including 412 Precondition Failed.",
+  ],
+  coreSchemas: [
+    "Agent",
+    "Group",
+    "Person",
+    "Verb",
+    "Activity",
+    "ContextAgent",
+    "ContextGroup",
+    "SubStatement",
+    "Result",
+    "Context",
+    "Attachment",
+    "Statement",
+    "StatementResult",
+    "AboutResource",
+    "StatementsQuery",
+    "AgentsResourceQuery",
+    "ActivitiesResourceQuery",
+    "StateDocumentQuery",
+    "StateDocumentListingQuery",
+    "AgentProfileDocumentQuery",
+    "AgentProfileDocumentListingQuery",
+    "ActivityProfileDocumentQuery",
+    "ActivityProfileDocumentListingQuery",
+    "XapiDocumentIdList",
+    "HttpMethod",
+    "Resource",
+    "RequestHeader",
+    "ResponseHeader",
+    "ErrorCode",
+    "ErrorResponse",
+    "Concurrency",
+    "MultipartAttachmentPart",
+    "MultipartRequest",
+  ],
+} as const;
+
+export {
+  ContextV2Schema as ContextSchema,
+  StatementObjectV2Schema as StatementObjectSchema,
+  StatementResultV2Schema as StatementResultSchema,
+  StatementSubmissionV2Schema as StatementSubmissionSchema,
+  StatementV2Schema as StatementSchema,
+  SubStatementV2Schema as SubStatementSchema,
+  XapiMultipartRequestV2Schema as XapiMultipartRequestSchema,
+};
+
+export const Schemas = XapiV2_0.Schemas;
+export const Shared = XapiV2_0.Shared;
+export const DerivedZodTemplates = XapiV2_0DerivedZodTemplates;
+// Inferred types from exported Zod validators.
+export type ContextAgent = z.infer<typeof ContextAgentSchema>;
+export type ContextGroup = z.infer<typeof ContextGroupSchema>;
+export type ContextV2 = z.infer<typeof ContextV2Schema>;
+export type SubStatementV2 = z.infer<typeof SubStatementV2Schema>;
+export type StatementObjectV2 = z.infer<typeof StatementObjectV2Schema>;
+export type StatementV2 = z.infer<typeof StatementV2Schema>;
+export type StatementSubmissionV2 = z.infer<typeof StatementSubmissionV2Schema>;
+export type StatementResultV2 = z.infer<typeof StatementResultV2Schema>;
+export type XapiMultipartRequestV2 = z.infer<typeof XapiMultipartRequestV2Schema>;

package/test/caliper-v1_2.test.ts

@@ -0,0 +1,270 @@
+import { expect, test } from "bun:test";
+
+import { CaliperV1_2 } from "../src";
+
+test("ActionSchema validates Caliper action vocabulary", () => {
+  expect(CaliperV1_2.ActionSchema.safeParse("Viewed").success).toBe(true);
+  expect(CaliperV1_2.ActionSchema.safeParse("ViewedSomethingElse").success).toBe(false);
+});
+
+test("PersonSchema requires top-level @context for described entity documents", () => {
+  const withContext = CaliperV1_2.PersonSchema.safeParse({
+    id: "https://example.edu/users/ada",
+    type: "Person",
+    "@context": "http://purl.imsglobal.org/ctx/caliper/v1p2",
+    name: "Ada Lovelace",
+  });
+  const withoutContext = CaliperV1_2.PersonSchema.safeParse({
+    id: "https://example.edu/users/ada",
+    type: "Person",
+    name: "Ada Lovelace",
+  });
+
+  expect(withContext.success).toBe(true);
+  expect(withoutContext.success).toBe(false);
+});
+
+test("EventSchema enforces URN UUID ids and UTC-millisecond eventTime", () => {
+  const valid = CaliperV1_2.EventSchema.safeParse({
+    type: "Event",
+    "@context": "http://purl.imsglobal.org/ctx/caliper/v1p2",
+    id: "urn:uuid:87a9fdf1-2f57-4d2d-b7e9-963cb0f89f9f",
+    actor: "https://example.edu/users/ada",
+    action: "Viewed",
+    object: "https://example.edu/resources/chapter-1",
+    eventTime: "2026-01-15T12:45:00.000Z",
+  });
+  const badId = CaliperV1_2.EventSchema.safeParse({
+    type: "Event",
+    "@context": "http://purl.imsglobal.org/ctx/caliper/v1p2",
+    id: "https://example.edu/events/123",
+    actor: "https://example.edu/users/ada",
+    action: "Viewed",
+    object: "https://example.edu/resources/chapter-1",
+    eventTime: "2026-01-15T12:45:00.000Z",
+  });
+  const badTime = CaliperV1_2.EventSchema.safeParse({
+    type: "Event",
+    "@context": "http://purl.imsglobal.org/ctx/caliper/v1p2",
+    id: "urn:uuid:87a9fdf1-2f57-4d2d-b7e9-963cb0f89f9f",
+    actor: "https://example.edu/users/ada",
+    action: "Viewed",
+    object: "https://example.edu/resources/chapter-1",
+    eventTime: "2026-01-15T12:45:00+08:00",
+  });
+
+  expect(valid.success).toBe(true);
+  expect(badId.success).toBe(false);
+  expect(badTime.success).toBe(false);
+});
+
+test("AnnotationEventSchema enforces textual actor/action/object constraints", () => {
+  const valid = CaliperV1_2.AnnotationEventSchema.safeParse({
+    type: "AnnotationEvent",
+    "@context": "http://purl.imsglobal.org/ctx/caliper/v1p2",
+    id: "urn:uuid:87a9fdf1-2f57-4d2d-b7e9-963cb0f89f9f",
+    actor: {
+      id: "https://example.edu/users/ada",
+      type: "Person",
+    },
+    action: "Bookmarked",
+    object: {
+      id: "https://example.edu/resources/chapter-1",
+      type: "DigitalResource",
+    },
+    generated: {
+      id: "https://example.edu/annotations/1",
+      type: "BookmarkAnnotation",
+    },
+    eventTime: "2026-01-15T12:45:00.000Z",
+    profile: "AnnotationProfile",
+  });
+
+  const badAction = CaliperV1_2.AnnotationEventSchema.safeParse({
+    type: "AnnotationEvent",
+    "@context": "http://purl.imsglobal.org/ctx/caliper/v1p2",
+    id: "urn:uuid:87a9fdf1-2f57-4d2d-b7e9-963cb0f89f9f",
+    actor: {
+      id: "https://example.edu/users/ada",
+      type: "Person",
+    },
+    action: "NavigatedTo",
+    object: {
+      id: "https://example.edu/resources/chapter-1",
+      type: "DigitalResource",
+    },
+    eventTime: "2026-01-15T12:45:00.000Z",
+  });
+
+  const badObjectType = CaliperV1_2.AnnotationEventSchema.safeParse({
+    type: "AnnotationEvent",
+    "@context": "http://purl.imsglobal.org/ctx/caliper/v1p2",
+    id: "urn:uuid:87a9fdf1-2f57-4d2d-b7e9-963cb0f89f9f",
+    actor: {
+      id: "https://example.edu/users/ada",
+      type: "Person",
+    },
+    action: "Bookmarked",
+    object: {
+      id: "https://example.edu/resources/chapter-1",
+      type: "Assessment",
+    },
+    eventTime: "2026-01-15T12:45:00.000Z",
+  });
+
+  expect(valid.success).toBe(true);
+  expect(badAction.success).toBe(false);
+  expect(badObjectType.success).toBe(false);
+});
+
+test("MessageEventSchema accepts MarkedAsUnRead textual alias", () => {
+  const parsed = CaliperV1_2.MessageEventSchema.safeParse({
+    type: "MessageEvent",
+    "@context": "http://purl.imsglobal.org/ctx/caliper/v1p2",
+    id: "urn:uuid:87a9fdf1-2f57-4d2d-b7e9-963cb0f89f9f",
+    actor: {
+      id: "https://example.edu/users/ada",
+      type: "Person",
+    },
+    action: "MarkedAsUnRead",
+    object: {
+      id: "https://example.edu/messages/1",
+      type: "Message",
+    },
+    eventTime: "2026-01-15T12:45:00.000Z",
+    profile: "ForumProfile",
+  });
+
+  expect(parsed.success).toBe(true);
+});
+
+test("ViewEventSchema restricts target entity type to Frame", () => {
+  const valid = CaliperV1_2.ViewEventSchema.safeParse({
+    type: "ViewEvent",
+    "@context": "http://purl.imsglobal.org/ctx/caliper/v1p2",
+    id: "urn:uuid:87a9fdf1-2f57-4d2d-b7e9-963cb0f89f9f",
+    actor: {
+      id: "https://example.edu/users/ada",
+      type: "Person",
+    },
+    action: "Viewed",
+    object: {
+      id: "https://example.edu/resources/chapter-1",
+      type: "Page",
+    },
+    target: {
+      id: "https://example.edu/resources/chapter-1#fragment",
+      type: "Frame",
+    },
+    eventTime: "2026-01-15T12:45:00.000Z",
+  });
+  const invalidTarget = CaliperV1_2.ViewEventSchema.safeParse({
+    type: "ViewEvent",
+    "@context": "http://purl.imsglobal.org/ctx/caliper/v1p2",
+    id: "urn:uuid:87a9fdf1-2f57-4d2d-b7e9-963cb0f89f9f",
+    actor: {
+      id: "https://example.edu/users/ada",
+      type: "Person",
+    },
+    action: "Viewed",
+    object: {
+      id: "https://example.edu/resources/chapter-1",
+      type: "Page",
+    },
+    target: {
+      id: "https://example.edu/resources/chapter-1#fragment",
+      type: "MediaLocation",
+    },
+    eventTime: "2026-01-15T12:45:00.000Z",
+  });
+
+  expect(valid.success).toBe(true);
+  expect(invalidTarget.success).toBe(false);
+});
+
+test("EnvelopeSchema enforces required fields and disallows custom top-level properties", () => {
+  const valid = CaliperV1_2.EnvelopeSchema.safeParse({
+    sensor: "https://example.edu/sensors/lms",
+    dataVersion: "http://purl.imsglobal.org/ctx/caliper/v1p2",
+    sendTime: "2026-01-15T12:50:00.000Z",
+    data: [
+      {
+        type: "ViewEvent",
+        "@context": "http://purl.imsglobal.org/ctx/caliper/v1p2",
+        id: "urn:uuid:87a9fdf1-2f57-4d2d-b7e9-963cb0f89f9f",
+        actor: "https://example.edu/users/ada",
+        action: "Viewed",
+        object: "https://example.edu/resources/chapter-1",
+        eventTime: "2026-01-15T12:45:00.000Z",
+      },
+    ],
+  });
+  const missingRequired = CaliperV1_2.EnvelopeSchema.safeParse({
+    sensor: "https://example.edu/sensors/lms",
+    dataVersion: "http://purl.imsglobal.org/ctx/caliper/v1p2",
+    data: [],
+  });
+  const extraProperty = CaliperV1_2.EnvelopeSchema.safeParse({
+    sensor: "https://example.edu/sensors/lms",
+    dataVersion: "http://purl.imsglobal.org/ctx/caliper/v1p2",
+    sendTime: "2026-01-15T12:50:00.000Z",
+    data: [
+      {
+        type: "ViewEvent",
+        "@context": "http://purl.imsglobal.org/ctx/caliper/v1p2",
+        id: "urn:uuid:87a9fdf1-2f57-4d2d-b7e9-963cb0f89f9f",
+        actor: "https://example.edu/users/ada",
+        action: "Viewed",
+        object: "https://example.edu/resources/chapter-1",
+        eventTime: "2026-01-15T12:45:00.000Z",
+      },
+    ],
+    custom: true,
+  });
+
+  expect(valid.success).toBe(true);
+  expect(missingRequired.success).toBe(false);
+  expect(extraProperty.success).toBe(false);
+});
+
+test("TextPositionSelectorSchema requires type/start/end", () => {
+  const valid = CaliperV1_2.TextPositionSelectorSchema.safeParse({
+    type: "TextPositionSelector",
+    start: 12,
+    end: 24,
+  });
+  const invalid = CaliperV1_2.TextPositionSelectorSchema.safeParse({
+    start: 12,
+    end: 24,
+  });
+
+  expect(valid.success).toBe(true);
+  expect(invalid.success).toBe(false);
+});
+
+test("SystemIdentifierSchema validates required identifier fields", () => {
+  const valid = CaliperV1_2.SystemIdentifierSchema.safeParse({
+    type: "SystemIdentifier",
+    identifier: "user-123",
+    identifierType: "LtiUserId",
+  });
+  const invalid = CaliperV1_2.SystemIdentifierSchema.safeParse({
+    type: "SystemIdentifier",
+    identifier: "user-123",
+  });
+
+  expect(valid.success).toBe(true);
+  expect(invalid.success).toBe(false);
+});
+
+test("Caliper12DerivedZodTemplates exposes key Caliper entry points and conformance metadata", () => {
+  expect(CaliperV1_2.Caliper12DerivedZodTemplates.envelope).toBe(CaliperV1_2.EnvelopeSchema);
+  expect(CaliperV1_2.Caliper12DerivedZodTemplates.event).toBe(CaliperV1_2.EventSchema);
+  expect(CaliperV1_2.Caliper12DerivedZodTemplates.person).toBe(CaliperV1_2.PersonSchema);
+  expect(CaliperV1_2.Caliper12DerivedZodTemplates.systemIdentifier).toBe(CaliperV1_2.SystemIdentifierSchema);
+  expect(CaliperV1_2.Caliper12DerivedZodTemplates.jsonSchemaEntryPoints.Action).toBe(CaliperV1_2.ActionSchema);
+  const annotationRule =
+    CaliperV1_2.Caliper12DerivedZodTemplates.conformance.supportedTextualEventRules.AnnotationEvent;
+  expect(annotationRule).toBeDefined();
+  expect(annotationRule?.profile).toBe("AnnotationProfile");
+});