@superbuilders/primer-tives 1.1.2 → 1.1.3

package/dist/contracts/types.d.ts

@@ -0,0 +1,118 @@
+import type { ContentBlock, ContentInline } from "../client/content";
+import type { PciId, PciProps, PciValue } from "../client/pci";
+interface MatchPair {
+    source: string;
+    target: string;
+}
+interface BodyStimulus {
+    type: "body";
+    body: ContentBlock[];
+}
+interface ImageStimulus {
+    type: "image";
+    description: ContentInline[];
+    src: string;
+}
+type RendererStimulus = BodyStimulus | ImageStimulus;
+interface RendererChoice {
+    identifier: string;
+    content: ContentInline[];
+}
+/**
+ * A choice in a match interaction — QTI 3.0 simpleAssociableChoice.
+ *
+ * matchMax: maximum number of pairs this choice may participate in.
+ *   0 = unbounded (QTI convention).
+ * matchMin: minimum number of pairs this choice must participate in.
+ *   0 = no minimum (QTI default).
+ */
+interface RendererMatchChoice {
+    identifier: string;
+    content: ContentInline[];
+    matchMax: number;
+    matchMin: number;
+}
+type PciInteraction<Pcis extends PciId = PciId> = {
+    [K in Pcis]: {
+        type: "portable-custom";
+        prompt: ContentInline[];
+        pciId: K;
+        properties: PciProps<K>;
+    };
+}[Pcis];
+type StandardRendererInteraction = {
+    type: "choice";
+    prompt: ContentInline[];
+    options: RendererChoice[];
+    shuffle: boolean;
+    maxChoices: number;
+    minChoices: number;
+} | {
+    type: "text-entry";
+    prompt: ContentInline[];
+    base: 10;
+    expectedLength?: number;
+    patternMask?: string;
+    placeholderText?: string;
+} | {
+    type: "extended-text";
+    cardinality: "single";
+    prompt: ContentInline[];
+    format: "plain";
+    expectedLength?: number;
+    expectedLines?: number;
+    patternMask?: string;
+    placeholderText?: string;
+} | {
+    type: "extended-text";
+    cardinality: "multiple";
+    prompt: ContentInline[];
+    format: "plain";
+    expectedLength?: number;
+    expectedLines?: number;
+    patternMask?: string;
+    placeholderText?: string;
+    minStrings: number;
+    maxStrings: number;
+} | {
+    type: "order";
+    prompt: ContentInline[];
+    choices: RendererChoice[];
+    shuffle: boolean;
+    minChoices: number;
+    maxChoices: number;
+} | {
+    type: "match";
+    prompt: ContentInline[];
+    sourceChoices: RendererMatchChoice[];
+    targetChoices: RendererMatchChoice[];
+    shuffle: boolean;
+    minAssociations: number;
+    maxAssociations: number;
+};
+type RendererInteraction<Pcis extends PciId = PciId> = StandardRendererInteraction | PciInteraction<Pcis>;
+type PciSubmission<Pcis extends PciId = PciId> = {
+    [K in Pcis]: {
+        type: "portable-custom";
+        pciId: K;
+        value: PciValue<K>;
+    };
+}[Pcis];
+type RendererSubmission<Pcis extends PciId = PciId> = {
+    type: "choice";
+    selectedKeys: string[];
+} | {
+    type: "text-entry";
+    value: string;
+} | {
+    type: "extended-text";
+    values: string[];
+} | {
+    type: "order";
+    orderedKeys: string[];
+} | {
+    type: "match";
+    pairs: MatchPair[];
+} | PciSubmission<Pcis>;
+export type { BodyStimulus, ImageStimulus, MatchPair, PciInteraction, PciSubmission, RendererChoice, RendererInteraction, RendererMatchChoice, RendererStimulus, RendererSubmission, StandardRendererInteraction };
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/contracts/validation.d.ts

@@ -0,0 +1,92 @@
+import { z } from "zod";
+import type { RendererInteraction, RendererSubmission } from "./types";
+declare const MatchPairSchema: z.ZodObject<{
+    source: z.ZodString;
+    target: z.ZodString;
+}, z.core.$strip>;
+declare const ChoiceSubmissionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"choice">;
+    selectedKeys: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+declare const TextEntrySubmissionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"text-entry">;
+    value: z.ZodString;
+}, z.core.$strip>;
+declare const ExtendedTextSubmissionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"extended-text">;
+    values: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+declare const OrderSubmissionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"order">;
+    orderedKeys: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+declare const MatchSubmissionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"match">;
+    pairs: z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        target: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const DivisionRemainderPciSubmissionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"portable-custom">;
+    pciId: z.ZodLiteral<"urn:primer:pci:division-remainder">;
+    value: z.ZodObject<{
+        quotient: z.ZodString;
+        remainder: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const FractionAdditionPciSubmissionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"portable-custom">;
+    pciId: z.ZodLiteral<"urn:primer:pci:fraction-addition">;
+    value: z.ZodObject<{
+        numerator: z.ZodString;
+        denominator: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const RendererSubmissionSchema: z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodLiteral<"choice">;
+    selectedKeys: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"text-entry">;
+    value: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"extended-text">;
+    values: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"order">;
+    orderedKeys: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"match">;
+    pairs: z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        target: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"portable-custom">;
+    pciId: z.ZodLiteral<"urn:primer:pci:division-remainder">;
+    value: z.ZodObject<{
+        quotient: z.ZodString;
+        remainder: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"portable-custom">;
+    pciId: z.ZodLiteral<"urn:primer:pci:fraction-addition">;
+    value: z.ZodObject<{
+        numerator: z.ZodString;
+        denominator: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>]>;
+type SubmissionValidationSuccess = {
+    ok: true;
+    value: RendererSubmission;
+};
+type SubmissionValidationFailure = {
+    ok: false;
+    issues: readonly string[];
+};
+type SubmissionValidationResult = SubmissionValidationSuccess | SubmissionValidationFailure;
+declare function validateSubmissionForInteraction(interaction: RendererInteraction, submission: RendererSubmission): SubmissionValidationResult;
+declare function submissionValidationMessage(result: SubmissionValidationFailure): string;
+export { ChoiceSubmissionSchema, DivisionRemainderPciSubmissionSchema, ExtendedTextSubmissionSchema, FractionAdditionPciSubmissionSchema, MatchPairSchema, MatchSubmissionSchema, OrderSubmissionSchema, RendererSubmissionSchema, TextEntrySubmissionSchema, submissionValidationMessage, validateSubmissionForInteraction };
+export type { SubmissionValidationFailure, SubmissionValidationResult, SubmissionValidationSuccess };
+//# sourceMappingURL=validation.d.ts.map

package/dist/contracts/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/contracts/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAQvB,OAAO,KAAK,EAGX,mBAAmB,EAEnB,kBAAkB,EAClB,MAAM,6CAA6C,CAAA;AAEpD,QAAA,MAAM,eAAe;;;iBAGnB,CAAA;AAEF,QAAA,MAAM,sBAAsB;;;iBAG1B,CAAA;AAEF,QAAA,MAAM,yBAAyB;;;iBAG7B,CAAA;AAEF,QAAA,MAAM,4BAA4B;;;iBAGhC,CAAA;AAEF,QAAA,MAAM,qBAAqB;;;iBAGzB,CAAA;AAEF,QAAA,MAAM,qBAAqB;;;;;;iBAGzB,CAAA;AAEF,QAAA,MAAM,oCAAoC;;;;;;;iBAIxC,CAAA;AAEF,QAAA,MAAM,mCAAmC;;;;;;;iBAIvC,CAAA;AAEF,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAQ5B,CAAA;AAuEF,KAAK,2BAA2B,GAAG;IAClC,EAAE,EAAE,IAAI,CAAA;IACR,KAAK,EAAE,kBAAkB,CAAA;CACzB,CAAA;AAED,KAAK,2BAA2B,GAAG;IAClC,EAAE,EAAE,KAAK,CAAA;IACT,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CACzB,CAAA;AAED,KAAK,0BAA0B,GAAG,2BAA2B,GAAG,2BAA2B,CAAA;AAuJ3F,iBAAS,gCAAgC,CACxC,WAAW,EAAE,mBAAmB,EAChC,UAAU,EAAE,kBAAkB,GAC5B,0BAA0B,CAiC5B;AAED,iBAAS,2BAA2B,CAAC,MAAM,EAAE,2BAA2B,GAAG,MAAM,CAEhF;AAED,OAAO,EACN,sBAAsB,EACtB,oCAAoC,EACpC,4BAA4B,EAC5B,mCAAmC,EACnC,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,gCAAgC,EAChC,CAAA;AACD,YAAY,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,CAAA"}

package/dist/errors.d.ts

@@ -0,0 +1,23 @@
+declare const ErrNetwork: Error;
+declare const ErrJsonParse: Error;
+declare const ErrUnsupportedPci: Error;
+declare const ErrInvalidAccessToken: Error;
+declare const ErrMalformedAccessToken: Error;
+declare const ErrTokenExpired: Error;
+declare const ErrBadRequest: Error;
+declare const ErrServerError: Error;
+declare const ErrTimeout: Error;
+declare const ErrForbidden: Error;
+declare const ErrNotFound: Error;
+declare const ErrConflict: Error;
+declare const ErrExternalAuthorityRequired: Error;
+declare const ErrRateLimited: Error;
+declare const ErrServiceUnavailable: Error;
+declare const ErrNotSerializable: Error;
+declare const ErrInvalidSubmission: Error;
+declare const ErrInvalidSecretKey: Error;
+declare const ErrStudentNotFound: Error;
+declare const ErrUnsupportedGrade: Error;
+declare const ErrTimebackUnavailable: Error;
+export { ErrBadRequest, ErrConflict, ErrExternalAuthorityRequired, ErrForbidden, ErrInvalidAccessToken, ErrInvalidSecretKey, ErrInvalidSubmission, ErrJsonParse, ErrMalformedAccessToken, ErrNetwork, ErrNotFound, ErrNotSerializable, ErrRateLimited, ErrServerError, ErrServiceUnavailable, ErrStudentNotFound, ErrTimebackUnavailable, ErrTimeout, ErrTokenExpired, ErrUnsupportedGrade, ErrUnsupportedPci };
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,UAAU,OAAwB,CAAA;AACxC,QAAA,MAAM,YAAY,OAA2B,CAAA;AAC7C,QAAA,MAAM,iBAAiB,OAAgC,CAAA;AACvD,QAAA,MAAM,qBAAqB,OAAqC,CAAA;AAChE,QAAA,MAAM,uBAAuB,OAAuC,CAAA;AACpE,QAAA,MAAM,eAAe,OAAqC,CAAA;AAC1D,QAAA,MAAM,aAAa,OAA4B,CAAA;AAC/C,QAAA,MAAM,cAAc,OAA6B,CAAA;AACjD,QAAA,MAAM,UAAU,OAAwB,CAAA;AACxC,QAAA,MAAM,YAAY,OAA0B,CAAA;AAC5C,QAAA,MAAM,WAAW,OAA0B,CAAA;AAC3C,QAAA,MAAM,WAAW,OAAyB,CAAA;AAC1C,QAAA,MAAM,4BAA4B,OAA4C,CAAA;AAC9E,QAAA,MAAM,cAAc,OAA6B,CAAA;AACjD,QAAA,MAAM,qBAAqB,OAAoC,CAAA;AAC/D,QAAA,MAAM,kBAAkB,OAEvB,CAAA;AACD,QAAA,MAAM,oBAAoB,OAAmC,CAAA;AAE7D,QAAA,MAAM,mBAAmB,OAAmC,CAAA;AAC5D,QAAA,MAAM,kBAAkB,OAAkC,CAAA;AAC1D,QAAA,MAAM,mBAAmB,OAAkC,CAAA;AAC3D,QAAA,MAAM,sBAAsB,OAAqC,CAAA;AAEjE,OAAO,EACN,aAAa,EACb,WAAW,EACX,4BAA4B,EAC5B,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,uBAAuB,EACvB,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,CAAA"}

package/dist/errors.js

@@ -0,0 +1,48 @@
+// src/errors.ts
+import * as errors from "@superbuilders/errors";
+var ErrNetwork = errors.new("network");
+var ErrJsonParse = errors.new("json parse");
+var ErrUnsupportedPci = errors.new("unsupported pci");
+var ErrInvalidAccessToken = errors.new("invalid access token");
+var ErrMalformedAccessToken = errors.new("malformed access token");
+var ErrTokenExpired = errors.new("access token expired");
+var ErrBadRequest = errors.new("bad request");
+var ErrServerError = errors.new("server error");
+var ErrTimeout = errors.new("timeout");
+var ErrForbidden = errors.new("forbidden");
+var ErrNotFound = errors.new("not found");
+var ErrConflict = errors.new("conflict");
+var ErrExternalAuthorityRequired = errors.new("external authority required");
+var ErrRateLimited = errors.new("rate limited");
+var ErrServiceUnavailable = errors.new("service unavailable");
+var ErrNotSerializable = errors.new("PrimerState is live in-memory state and must not be serialized or stored");
+var ErrInvalidSubmission = errors.new("invalid submission");
+var ErrInvalidSecretKey = errors.new("invalid secret key");
+var ErrStudentNotFound = errors.new("student not found");
+var ErrUnsupportedGrade = errors.new("unsupported grade");
+var ErrTimebackUnavailable = errors.new("timeback unavailable");
+export {
+  ErrUnsupportedPci,
+  ErrUnsupportedGrade,
+  ErrTokenExpired,
+  ErrTimeout,
+  ErrTimebackUnavailable,
+  ErrStudentNotFound,
+  ErrServiceUnavailable,
+  ErrServerError,
+  ErrRateLimited,
+  ErrNotSerializable,
+  ErrNotFound,
+  ErrNetwork,
+  ErrMalformedAccessToken,
+  ErrJsonParse,
+  ErrInvalidSubmission,
+  ErrInvalidSecretKey,
+  ErrInvalidAccessToken,
+  ErrForbidden,
+  ErrExternalAuthorityRequired,
+  ErrConflict,
+  ErrBadRequest
+};
+
+//# debugId=4F60AD86845EC38864756E2164756E21

package/dist/errors.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/errors.ts"],
+  "sourcesContent": [
+    "import * as errors from \"@superbuilders/errors\"\n\nconst ErrNetwork = errors.new(\"network\")\nconst ErrJsonParse = errors.new(\"json parse\")\nconst ErrUnsupportedPci = errors.new(\"unsupported pci\")\nconst ErrInvalidAccessToken = errors.new(\"invalid access token\")\nconst ErrMalformedAccessToken = errors.new(\"malformed access token\")\nconst ErrTokenExpired = errors.new(\"access token expired\")\nconst ErrBadRequest = errors.new(\"bad request\")\nconst ErrServerError = errors.new(\"server error\")\nconst ErrTimeout = errors.new(\"timeout\")\nconst ErrForbidden = errors.new(\"forbidden\")\nconst ErrNotFound = errors.new(\"not found\")\nconst ErrConflict = errors.new(\"conflict\")\nconst ErrExternalAuthorityRequired = errors.new(\"external authority required\")\nconst ErrRateLimited = errors.new(\"rate limited\")\nconst ErrServiceUnavailable = errors.new(\"service unavailable\")\nconst ErrNotSerializable = errors.new(\n\t\"PrimerState is live in-memory state and must not be serialized or stored\"\n)\nconst ErrInvalidSubmission = errors.new(\"invalid submission\")\n\nconst ErrInvalidSecretKey = errors.new(\"invalid secret key\")\nconst ErrStudentNotFound = errors.new(\"student not found\")\nconst ErrUnsupportedGrade = errors.new(\"unsupported grade\")\nconst ErrTimebackUnavailable = errors.new(\"timeback unavailable\")\n\nexport {\n\tErrBadRequest,\n\tErrConflict,\n\tErrExternalAuthorityRequired,\n\tErrForbidden,\n\tErrInvalidAccessToken,\n\tErrInvalidSecretKey,\n\tErrInvalidSubmission,\n\tErrJsonParse,\n\tErrMalformedAccessToken,\n\tErrNetwork,\n\tErrNotFound,\n\tErrNotSerializable,\n\tErrRateLimited,\n\tErrServerError,\n\tErrServiceUnavailable,\n\tErrStudentNotFound,\n\tErrTimebackUnavailable,\n\tErrTimeout,\n\tErrTokenExpired,\n\tErrUnsupportedGrade,\n\tErrUnsupportedPci\n}\n"
+  ],
+  "mappings": ";AAAA;AAEA,IAAM,aAAoB,WAAI,SAAS;AACvC,IAAM,eAAsB,WAAI,YAAY;AAC5C,IAAM,oBAA2B,WAAI,iBAAiB;AACtD,IAAM,wBAA+B,WAAI,sBAAsB;AAC/D,IAAM,0BAAiC,WAAI,wBAAwB;AACnE,IAAM,kBAAyB,WAAI,sBAAsB;AACzD,IAAM,gBAAuB,WAAI,aAAa;AAC9C,IAAM,iBAAwB,WAAI,cAAc;AAChD,IAAM,aAAoB,WAAI,SAAS;AACvC,IAAM,eAAsB,WAAI,WAAW;AAC3C,IAAM,cAAqB,WAAI,WAAW;AAC1C,IAAM,cAAqB,WAAI,UAAU;AACzC,IAAM,+BAAsC,WAAI,6BAA6B;AAC7E,IAAM,iBAAwB,WAAI,cAAc;AAChD,IAAM,wBAA+B,WAAI,qBAAqB;AAC9D,IAAM,qBAA4B,WACjC,0EACD;AACA,IAAM,uBAA8B,WAAI,oBAAoB;AAE5D,IAAM,sBAA6B,WAAI,oBAAoB;AAC3D,IAAM,qBAA4B,WAAI,mBAAmB;AACzD,IAAM,sBAA6B,WAAI,mBAAmB;AAC1D,IAAM,yBAAgC,WAAI,sBAAsB;",
+  "debugId": "4F60AD86845EC38864756E2164756E21",
+  "names": []
+}

package/dist/grade-level.d.ts

@@ -0,0 +1,5 @@
+declare const GRADE_LEVELS: readonly ["K", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12"];
+type GradeLevel = (typeof GRADE_LEVELS)[number];
+export { GRADE_LEVELS };
+export type { GradeLevel };
+//# sourceMappingURL=grade-level.d.ts.map

package/dist/grade-level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade-level.d.ts","sourceRoot":"","sources":["../src/grade-level.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,YAAY,+EAAgF,CAAA;AAElG,KAAK,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/C,OAAO,EAAE,YAAY,EAAE,CAAA;AACvB,YAAY,EAAE,UAAU,EAAE,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./contracts";
+export * from "./errors";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,344 @@
+// src/contracts/validation.ts
+import { z as z2 } from "zod";
+
+// src/contracts/pci-schemas.ts
+import { z } from "zod";
+var DivisionRemainderPropsSchema = z.object({
+  dividend: z.number(),
+  divisor: z.number()
+});
+var DivisionRemainderSubmissionSchema = z.object({
+  quotient: z.string(),
+  remainder: z.string()
+});
+var FractionOperandSchema = z.object({
+  numerator: z.number(),
+  denominator: z.number()
+});
+var FractionAdditionPropsSchema = z.object({
+  left: FractionOperandSchema,
+  right: FractionOperandSchema
+});
+var FractionAdditionSubmissionSchema = z.object({
+  numerator: z.string(),
+  denominator: z.string()
+});
+
+// src/contracts/validation.ts
+var MatchPairSchema = z2.object({
+  source: z2.string(),
+  target: z2.string()
+});
+var ChoiceSubmissionSchema = z2.object({
+  type: z2.literal("choice"),
+  selectedKeys: z2.array(z2.string())
+});
+var TextEntrySubmissionSchema = z2.object({
+  type: z2.literal("text-entry"),
+  value: z2.string()
+});
+var ExtendedTextSubmissionSchema = z2.object({
+  type: z2.literal("extended-text"),
+  values: z2.array(z2.string()).min(1)
+});
+var OrderSubmissionSchema = z2.object({
+  type: z2.literal("order"),
+  orderedKeys: z2.array(z2.string())
+});
+var MatchSubmissionSchema = z2.object({
+  type: z2.literal("match"),
+  pairs: z2.array(MatchPairSchema)
+});
+var DivisionRemainderPciSubmissionSchema = z2.object({
+  type: z2.literal("portable-custom"),
+  pciId: z2.literal("urn:primer:pci:division-remainder"),
+  value: DivisionRemainderSubmissionSchema
+});
+var FractionAdditionPciSubmissionSchema = z2.object({
+  type: z2.literal("portable-custom"),
+  pciId: z2.literal("urn:primer:pci:fraction-addition"),
+  value: FractionAdditionSubmissionSchema
+});
+var RendererSubmissionSchema = z2.union([
+  ChoiceSubmissionSchema,
+  TextEntrySubmissionSchema,
+  ExtendedTextSubmissionSchema,
+  OrderSubmissionSchema,
+  MatchSubmissionSchema,
+  DivisionRemainderPciSubmissionSchema,
+  FractionAdditionPciSubmissionSchema
+]);
+function duplicates(values, keyOf) {
+  const seen = new Set;
+  const duplicated = new Set;
+  for (const value of values) {
+    const key = keyOf(value);
+    if (seen.has(key)) {
+      duplicated.add(key);
+      continue;
+    }
+    seen.add(key);
+  }
+  return [...duplicated];
+}
+function findUnknownIds(values, choices) {
+  const ids = new Set(choices.map(function getId(choice) {
+    return choice.identifier;
+  }));
+  return values.filter(function isUnknown(value) {
+    return !ids.has(value);
+  });
+}
+function countByIdentifier(pairs, side) {
+  const counts = new Map;
+  for (const pair of pairs) {
+    const key = pair[side];
+    const currentCount = counts.get(key);
+    if (currentCount === undefined) {
+      counts.set(key, 1);
+      continue;
+    }
+    counts.set(key, currentCount + 1);
+  }
+  return counts;
+}
+function validateUsageBounds(choices, counts, side) {
+  const issues = [];
+  for (const choice of choices) {
+    const maybeCount = counts.get(choice.identifier);
+    const count = maybeCount === undefined ? 0 : maybeCount;
+    if (choice.matchMax !== 0 && count > choice.matchMax) {
+      issues.push(`${side} '${choice.identifier}' used ${count} times, max ${choice.matchMax}`);
+    }
+    if (count < choice.matchMin) {
+      issues.push(`${side} '${choice.identifier}' used ${count} times, min ${choice.matchMin}`);
+    }
+  }
+  return issues;
+}
+function pciSubmissionSchema(pciId) {
+  switch (pciId) {
+    case "urn:primer:pci:division-remainder":
+      return DivisionRemainderSubmissionSchema;
+    case "urn:primer:pci:fraction-addition":
+      return FractionAdditionSubmissionSchema;
+  }
+  const exhaustiveCheck = pciId;
+  return exhaustiveCheck;
+}
+function typeMismatch(interactionType, submissionType) {
+  return `submission type '${submissionType}' does not match interaction type '${interactionType}'`;
+}
+function buildResult(submission, issues) {
+  if (issues.length > 0) {
+    return { ok: false, issues };
+  }
+  return { ok: true, value: submission };
+}
+function validateChoice(interaction, submission) {
+  const issues = [];
+  if (submission.selectedKeys.length < interaction.minChoices) {
+    issues.push(`need at least ${interaction.minChoices} selections`);
+  }
+  if (submission.selectedKeys.length > interaction.maxChoices) {
+    issues.push(`at most ${interaction.maxChoices} selections`);
+  }
+  const duplicateKeys = duplicates(submission.selectedKeys, function keyOf(value) {
+    return value;
+  });
+  if (duplicateKeys.length > 0) {
+    issues.push("duplicate selections");
+  }
+  const unknownKeys = findUnknownIds(submission.selectedKeys, interaction.options);
+  if (unknownKeys.length > 0) {
+    issues.push(`unknown options: ${unknownKeys.join(", ")}`);
+  }
+  return issues;
+}
+function validateExtendedText(interaction, submission) {
+  const issues = [];
+  if (interaction.cardinality === "single") {
+    if (submission.values.length !== 1) {
+      issues.push("single-cardinality extended-text requires exactly one value");
+    }
+    return issues;
+  }
+  if (submission.values.length < interaction.minStrings) {
+    issues.push(`need at least ${interaction.minStrings} values`);
+  }
+  if (submission.values.length > interaction.maxStrings) {
+    issues.push(`at most ${interaction.maxStrings} values`);
+  }
+  const duplicateValues = duplicates(submission.values, function keyOf(value) {
+    return value;
+  });
+  if (duplicateValues.length > 0) {
+    issues.push("duplicate values are not allowed for multiple-cardinality extended-text");
+  }
+  return issues;
+}
+function validateOrder(interaction, submission) {
+  const issues = [];
+  if (submission.orderedKeys.length < interaction.minChoices) {
+    issues.push(`need at least ${interaction.minChoices} selections`);
+  }
+  if (submission.orderedKeys.length > interaction.maxChoices) {
+    issues.push(`at most ${interaction.maxChoices} selections`);
+  }
+  const duplicateKeys = duplicates(submission.orderedKeys, function keyOf(value) {
+    return value;
+  });
+  if (duplicateKeys.length > 0) {
+    issues.push("duplicate selections");
+  }
+  const unknownKeys = findUnknownIds(submission.orderedKeys, interaction.choices);
+  if (unknownKeys.length > 0) {
+    issues.push(`unknown choices: ${unknownKeys.join(", ")}`);
+  }
+  return issues;
+}
+function validateMatch(interaction, submission) {
+  const issues = [];
+  if (submission.pairs.length < interaction.minAssociations) {
+    issues.push(`need at least ${interaction.minAssociations} associations`);
+  }
+  if (submission.pairs.length > interaction.maxAssociations) {
+    issues.push(`at most ${interaction.maxAssociations} associations`);
+  }
+  const duplicatePairs = duplicates(submission.pairs, function keyOf(pair) {
+    return `${pair.source}->${pair.target}`;
+  });
+  if (duplicatePairs.length > 0) {
+    issues.push("duplicate associations are not allowed");
+  }
+  const sourceIds = new Set(interaction.sourceChoices.map(function getId(choice) {
+    return choice.identifier;
+  }));
+  const targetIds = new Set(interaction.targetChoices.map(function getId(choice) {
+    return choice.identifier;
+  }));
+  for (const pair of submission.pairs) {
+    if (!sourceIds.has(pair.source)) {
+      issues.push(`unknown source '${pair.source}'`);
+    }
+    if (!targetIds.has(pair.target)) {
+      issues.push(`unknown target '${pair.target}'`);
+    }
+  }
+  const sourceCounts = countByIdentifier(submission.pairs, "source");
+  const targetCounts = countByIdentifier(submission.pairs, "target");
+  issues.push(...validateUsageBounds(interaction.sourceChoices, sourceCounts, "source"));
+  issues.push(...validateUsageBounds(interaction.targetChoices, targetCounts, "target"));
+  return issues;
+}
+function validatePortableCustom(interaction, submission) {
+  if (submission.pciId !== interaction.pciId) {
+    return [
+      `submission PCI '${submission.pciId}' does not match interaction PCI '${interaction.pciId}'`
+    ];
+  }
+  const schema = pciSubmissionSchema(interaction.pciId);
+  const result = schema.safeParse(submission.value);
+  if (!result.success) {
+    return result.error.issues.map(function toIssue(issue) {
+      return issue.message;
+    });
+  }
+  return [];
+}
+function validateSubmissionForInteraction(interaction, submission) {
+  switch (interaction.type) {
+    case "choice":
+      if (submission.type !== "choice") {
+        return { ok: false, issues: [typeMismatch(interaction.type, submission.type)] };
+      }
+      return buildResult(submission, validateChoice(interaction, submission));
+    case "text-entry":
+      if (submission.type !== "text-entry") {
+        return { ok: false, issues: [typeMismatch(interaction.type, submission.type)] };
+      }
+      return { ok: true, value: submission };
+    case "extended-text":
+      if (submission.type !== "extended-text") {
+        return { ok: false, issues: [typeMismatch(interaction.type, submission.type)] };
+      }
+      return buildResult(submission, validateExtendedText(interaction, submission));
+    case "order":
+      if (submission.type !== "order") {
+        return { ok: false, issues: [typeMismatch(interaction.type, submission.type)] };
+      }
+      return buildResult(submission, validateOrder(interaction, submission));
+    case "match":
+      if (submission.type !== "match") {
+        return { ok: false, issues: [typeMismatch(interaction.type, submission.type)] };
+      }
+      return buildResult(submission, validateMatch(interaction, submission));
+    case "portable-custom":
+      if (submission.type !== "portable-custom") {
+        return { ok: false, issues: [typeMismatch(interaction.type, submission.type)] };
+      }
+      return buildResult(submission, validatePortableCustom(interaction, submission));
+  }
+}
+function submissionValidationMessage(result) {
+  return result.issues.join("; ");
+}
+// src/errors.ts
+import * as errors from "@superbuilders/errors";
+var ErrNetwork = errors.new("network");
+var ErrJsonParse = errors.new("json parse");
+var ErrUnsupportedPci = errors.new("unsupported pci");
+var ErrInvalidAccessToken = errors.new("invalid access token");
+var ErrMalformedAccessToken = errors.new("malformed access token");
+var ErrTokenExpired = errors.new("access token expired");
+var ErrBadRequest = errors.new("bad request");
+var ErrServerError = errors.new("server error");
+var ErrTimeout = errors.new("timeout");
+var ErrForbidden = errors.new("forbidden");
+var ErrNotFound = errors.new("not found");
+var ErrConflict = errors.new("conflict");
+var ErrExternalAuthorityRequired = errors.new("external authority required");
+var ErrRateLimited = errors.new("rate limited");
+var ErrServiceUnavailable = errors.new("service unavailable");
+var ErrNotSerializable = errors.new("PrimerState is live in-memory state and must not be serialized or stored");
+var ErrInvalidSubmission = errors.new("invalid submission");
+var ErrInvalidSecretKey = errors.new("invalid secret key");
+var ErrStudentNotFound = errors.new("student not found");
+var ErrUnsupportedGrade = errors.new("unsupported grade");
+var ErrTimebackUnavailable = errors.new("timeback unavailable");
+export {
+  validateSubmissionForInteraction,
+  submissionValidationMessage,
+  TextEntrySubmissionSchema,
+  RendererSubmissionSchema,
+  OrderSubmissionSchema,
+  MatchSubmissionSchema,
+  MatchPairSchema,
+  FractionAdditionPciSubmissionSchema,
+  ExtendedTextSubmissionSchema,
+  ErrUnsupportedPci,
+  ErrUnsupportedGrade,
+  ErrTokenExpired,
+  ErrTimeout,
+  ErrTimebackUnavailable,
+  ErrStudentNotFound,
+  ErrServiceUnavailable,
+  ErrServerError,
+  ErrRateLimited,
+  ErrNotSerializable,
+  ErrNotFound,
+  ErrNetwork,
+  ErrMalformedAccessToken,
+  ErrJsonParse,
+  ErrInvalidSubmission,
+  ErrInvalidSecretKey,
+  ErrInvalidAccessToken,
+  ErrForbidden,
+  ErrExternalAuthorityRequired,
+  ErrConflict,
+  ErrBadRequest,
+  DivisionRemainderPciSubmissionSchema,
+  ChoiceSubmissionSchema
+};
+
+//# debugId=7E9B1E6A8E723B5D64756E2164756E21