@superbuilders/primer-tives 4.1.0 → 5.0.1

package/README.md

@@ -19,7 +19,7 @@ bun add @superbuilders/primer-tives
 
 ## Version
 
-The current SDK version is `4.0.5`.
+The current SDK version is `5.0.0`.
 
 ## Entrypoints
 
@@ -384,7 +384,12 @@ async function runPrimer(initialState: PrimerState): Promise<void> {
 				state = await renderAndSubmitInteraction(state)
 				break
 			case "feedback":
-				renderFeedback(state.feedbackContent, state.assessmentOutcome, state.review)
+				if (state.feedbackKind === "submitted") {
+					renderSubmittedFeedback(state.feedbackContent, state.assessmentOutcome, state.review)
+				}
+				if (state.feedbackKind === "timedOut") {
+					renderTimeoutFeedback(state.feedbackContent)
+				}
 				state = await state.advance()
 				break
 			case "errored":
@@ -588,7 +593,7 @@ Every interaction state includes:
 | `stimulus` | Optional frame stimulus. |
 | `interaction` | Full interaction contract object. |
 | submit method | Kind-specific learner submission operation. |
-| `timeout()` | Records that the learner timed out or the host chose to end the attempt without a submission. |
+| `timeout()` | Records that the learner timed out or the host chose to end the attempt without a submission. A successful timeout resolves to timeout feedback before the next frame. |
 
 Submission methods validate standard interaction payloads before runtime submission. Invalid standard submissions return `ErroredState` with `ErrInvalidSubmission`.
 
@@ -807,8 +812,13 @@ type AssessmentOutcome = {
 	value: AssessmentOutcomeValue
 }
 
-interface FeedbackState<Pcis extends PciId = PciId> {
+type FeedbackState<Pcis extends PciId = PciId> =
+	| SubmittedFeedbackState<Pcis>
+	| TimedOutFeedbackState<Pcis>
+
+interface SubmittedFeedbackState<Pcis extends PciId = PciId> {
 	readonly phase: "feedback"
+	readonly feedbackKind: "submitted"
 	readonly body: ContentBlock[]
 	readonly stimulus: RendererStimulus | null
 	readonly interaction: RendererInteraction<Pcis>
@@ -818,9 +828,19 @@ interface FeedbackState<Pcis extends PciId = PciId> {
 	readonly review: InteractionReview<Pcis> | null
 	advance(): Promise<PrimerState<Pcis>>
 }
+
+interface TimedOutFeedbackState<Pcis extends PciId = PciId> {
+	readonly phase: "feedback"
+	readonly feedbackKind: "timedOut"
+	readonly body: ContentBlock[]
+	readonly stimulus: RendererStimulus | null
+	readonly interaction: RendererInteraction<Pcis>
+	readonly feedbackContent: ContentInline[]
+	advance(): Promise<PrimerState<Pcis>>
+}
 ```
 
-Feedback state is returned after a terminal learner submission. Render the submitted frame, submitted value, `assessmentOutcome.value`, feedback content, and optional review data. Call `advance()` when the learner is ready to continue.
+Feedback state is returned after a terminal learner submission or timeout. Switch on `feedbackKind`. Submitted feedback includes the submitted value, `assessmentOutcome.value`, feedback content, and optional review data. Timeout feedback has no submitted value and no correctness outcome. Call `advance()` when the learner is ready to continue.
 
 Repeated `advance()` calls while the first one is pending return the same pending result.
 
@@ -878,6 +898,7 @@ Fatal sentinels:
 | Sentinel | Meaning |
 | --- | --- |
 | `ErrBadRequest` | Primer rejected the runtime request as invalid for the SDK contract. |
+| `ErrCurriculumInstructionalUndeliverable` | The active curriculum instructional has no deliverable frame content. |
 | `ErrInvalidAccessToken` | The learner token was rejected. |
 | `ErrTokenExpired` | The learner token expired. |
 | `ErrForbidden` | The learner is not allowed to continue in this runtime scope. |
@@ -1100,7 +1121,7 @@ if (!validation.ok) {
 
 ## Review Types
 
-`FeedbackState.review` is `InteractionReview | null`.
+`SubmittedFeedbackState.review` is `InteractionReview | null`. Timeout feedback does not carry review data because no submission was graded.
 
 ```ts
 type InteractionReview<Pcis extends PciId = PciId> =
@@ -1134,7 +1155,7 @@ type ReviewScalarValue =
 	| { kind: "pair"; source: string; target: string }
 ```
 
-`review` is for renderer display and inspection. The assessment outcome lives on `FeedbackState.assessmentOutcome.value`.
+`review` is for renderer display and inspection. The assessment outcome lives on `SubmittedFeedbackState.assessmentOutcome.value`.
 
 ## PCI Registry
 
@@ -1255,6 +1276,7 @@ import {
 	ErrAuthUnavailable,
 	ErrBadRequest,
 	ErrConflict,
+	ErrCurriculumInstructionalUndeliverable,
 	ErrForbidden,
 	ErrInvalidAccessToken,
 	ErrInvalidSubmission,
@@ -1302,6 +1324,7 @@ Runtime errors are represented as `ErroredState` or `FatalState`.
 | `ErrJsonParse` | `ErroredState` | yes | Runtime data could not be interpreted as the SDK contract. |
 | `ErrInvalidSubmission` | `ErroredState` | no | Renderer submitted a value that is invalid for the active interaction. |
 | `ErrBadRequest` | `FatalState` | no | Runtime request violates the SDK contract. |
+| `ErrCurriculumInstructionalUndeliverable` | `FatalState` | no | Curriculum routing reached an instructional with no deliverable frame content. |
 | `ErrInvalidAccessToken` | `FatalState` | no | Learner token is invalid. |
 | `ErrTokenExpired` | `FatalState` | no | Learner token expired. |
 | `ErrForbidden` | `FatalState` | no | Learner cannot continue in this runtime scope. |
@@ -1369,6 +1392,10 @@ if (state.phase === "fatal") {
 		renderSdkUpgradeMessage()
 		return
 	}
+	if (errors.is(state.error, ErrCurriculumInstructionalUndeliverable)) {
+		renderContentUnavailableMessage()
+		return
+	}
 	logger.error({ error: state.error }, "primer fatal state")
 	throw state.error
 }
@@ -1442,6 +1469,7 @@ The runtime exchange shape is not public SDK surface. Tests should assert SDK se
 | first runtime work fails recoverably | `start` resolves to `ErroredState` with `retriable: true` |
 | first runtime work fails terminally | `start` resolves to `FatalState` |
 | unsupported PCI is presented | `start` resolves to `FatalState` with `ErrUnsupportedPci` |
+| curriculum instructional has no deliverable content | transition resolves to `FatalState` with `ErrCurriculumInstructionalUndeliverable` |
 | standard submission is invalid | submit method resolves to `ErroredState` with `ErrInvalidSubmission` |
 | concurrent submit/timeout conflict occurs | transition resolves to `ErroredState` with `ErrConflict` |
 | state is serialized | serialization throws `ErrNotSerializable` |

package/dist/client/auth/hosted-popup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-popup.d.ts","sourceRoot":"","sources":["../../../src/client/auth/hosted-popup.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AAMtE,KAAK,iBAAiB,GAAG;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAA;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAC7B,CAAA;AAgJD,iBAAe,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAU1E;AAED,YAAY,EAAE,iBAAiB,EAAE,CAAA;AACjC,OAAO,EAAE,gBAAgB,EAAE,CAAA"}
+{"version":3,"file":"hosted-popup.d.ts","sourceRoot":"","sources":["../../../src/client/auth/hosted-popup.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AAMtE,KAAK,iBAAiB,GAAG;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAA;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAC7B,CAAA;AA0PD,iBAAe,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAU1E;AAED,YAAY,EAAE,iBAAiB,EAAE,CAAA;AACjC,OAAO,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/client/choice-state.d.ts

@@ -1,10 +1,10 @@
 import type { SessionContext } from "./session-context";
-import type { PrimerState } from "./types";
+import type { InteractionFeedback, PrimerState } from "./types";
 import type { ContentBlock } from "../contracts/content";
 import type { PciId } from "../contracts/pci";
 import type { RendererChoice, RendererInteraction, RendererStimulus } from "../contracts/types";
 declare function choiceState<Pcis extends PciId>(ctx: SessionContext<Pcis>, body: ContentBlock[], stimulus: RendererStimulus | null, interaction: Extract<RendererInteraction<Pcis>, {
     type: "choice";
-}>, options: RendererChoice[], maxChoices: number, minChoices: number): PrimerState<Pcis>;
+}>, options: RendererChoice[], maxChoices: number, minChoices: number, feedback: InteractionFeedback | null): PrimerState<Pcis>;
 export { choiceState };
 //# sourceMappingURL=choice-state.d.ts.map

package/dist/client/choice-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"choice-state.d.ts","sourceRoot":"","sources":["../../src/client/choice-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AACxF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAA;AAK3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAA;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2CAA2C,CAAA;AACtE,OAAO,KAAK,EACX,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,MAAM,6CAA6C,CAAA;AAGpD,iBAAS,WAAW,CAAC,IAAI,SAAS,KAAK,EACtC,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,EACzB,IAAI,EAAE,YAAY,EAAE,EACpB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EACjC,WAAW,EAAE,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,EACnE,OAAO,EAAE,cAAc,EAAE,EACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAChB,WAAW,CAAC,IAAI,CAAC,CAsFnB;AAED,OAAO,EAAE,WAAW,EAAE,CAAA"}
+{"version":3,"file":"choice-state.d.ts","sourceRoot":"","sources":["../../src/client/choice-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AACxF,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAA;AAKhG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAA;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2CAA2C,CAAA;AACtE,OAAO,KAAK,EACX,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,MAAM,6CAA6C,CAAA;AAGpD,iBAAS,WAAW,CAAC,IAAI,SAAS,KAAK,EACtC,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,EACzB,IAAI,EAAE,YAAY,EAAE,EACpB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EACjC,WAAW,EAAE,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,EACnE,OAAO,EAAE,cAAc,EAAE,EACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAClC,WAAW,CAAC,IAAI,CAAC,CAuFnB;AAED,OAAO,EAAE,WAAW,EAAE,CAAA"}

package/dist/client/extended-text-state.d.ts

@@ -1,10 +1,10 @@
 import type { SessionContext } from "./session-context";
-import type { PrimerState } from "./types";
+import type { InteractionFeedback, PrimerState } from "./types";
 import type { ContentBlock } from "../contracts/content";
 import type { PciId } from "../contracts/pci";
 import type { RendererStimulus, StandardRendererInteraction } from "../contracts/types";
 declare function extendedTextState<Pcis extends PciId>(ctx: SessionContext<Pcis>, body: ContentBlock[], stimulus: RendererStimulus | null, interaction: Extract<StandardRendererInteraction, {
     type: "extended-text";
-}>): PrimerState<Pcis>;
+}>, feedback: InteractionFeedback | null): PrimerState<Pcis>;
 export { extendedTextState };
 //# sourceMappingURL=extended-text-state.d.ts.map

package/dist/client/extended-text-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extended-text-state.d.ts","sourceRoot":"","sources":["../../src/client/extended-text-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AACxF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAA;AAK3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAA;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2CAA2C,CAAA;AACtE,OAAO,KAAK,EACX,gBAAgB,EAChB,2BAA2B,EAC3B,MAAM,6CAA6C,CAAA;AAGpD,iBAAS,iBAAiB,CAAC,IAAI,SAAS,KAAK,EAC5C,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,EACzB,IAAI,EAAE,YAAY,EAAE,EACpB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EACjC,WAAW,EAAE,OAAO,CAAC,2BAA2B,EAAE;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC,GAC1E,WAAW,CAAC,IAAI,CAAC,CAuKnB;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAA"}
+{"version":3,"file":"extended-text-state.d.ts","sourceRoot":"","sources":["../../src/client/extended-text-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AACxF,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAA;AAKhG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAA;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2CAA2C,CAAA;AACtE,OAAO,KAAK,EACX,gBAAgB,EAChB,2BAA2B,EAC3B,MAAM,6CAA6C,CAAA;AAGpD,iBAAS,iBAAiB,CAAC,IAAI,SAAS,KAAK,EAC5C,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,EACzB,IAAI,EAAE,YAAY,EAAE,EACpB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EACjC,WAAW,EAAE,OAAO,CAAC,2BAA2B,EAAE;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC,EAC5E,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAClC,WAAW,CAAC,IAAI,CAAC,CAyKnB;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/client/feedback-state.d.ts

@@ -4,6 +4,7 @@ import type { ContentBlock, ContentInline } from "../contracts/content";
 import type { PciId } from "../contracts/pci";
 import type { InteractionReview } from "../contracts/review";
 import type { RendererInteraction, RendererStimulus, RendererSubmission } from "../contracts/types";
-declare function feedbackState<Pcis extends PciId>(ctx: SessionContext<Pcis>, body: ContentBlock[], stimulus: RendererStimulus | null, interaction: RendererInteraction<Pcis>, submission: RendererSubmission<Pcis>, assessmentOutcome: AssessmentOutcome, feedbackContent: ContentInline[], review: InteractionReview<Pcis> | null): PrimerState<Pcis>;
-export { feedbackState };
+declare function submittedFeedbackState<Pcis extends PciId>(ctx: SessionContext<Pcis>, body: ContentBlock[], stimulus: RendererStimulus | null, interaction: RendererInteraction<Pcis>, submission: RendererSubmission<Pcis>, assessmentOutcome: AssessmentOutcome, feedbackContent: ContentInline[], review: InteractionReview<Pcis> | null): PrimerState<Pcis>;
+declare function timedOutFeedbackState<Pcis extends PciId>(ctx: SessionContext<Pcis>, body: ContentBlock[], stimulus: RendererStimulus | null, interaction: RendererInteraction<Pcis>, feedbackContent: ContentInline[]): PrimerState<Pcis>;
+export { submittedFeedbackState, timedOutFeedbackState };
 //# sourceMappingURL=feedback-state.d.ts.map

package/dist/client/feedback-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feedback-state.d.ts","sourceRoot":"","sources":["../../src/client/feedback-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAA;AAC9F,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAA;AAChG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2CAA2C,CAAA;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAA;AACrF,OAAO,KAAK,EACX,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,MAAM,6CAA6C,CAAA;AAEpD,iBAAS,aAAa,CAAC,IAAI,SAAS,KAAK,EACxC,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,EACzB,IAAI,EAAE,YAAY,EAAE,EACpB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EACjC,WAAW,EAAE,mBAAmB,CAAC,IAAI,CAAC,EACtC,UAAU,EAAE,kBAAkB,CAAC,IAAI,CAAC,EACpC,iBAAiB,EAAE,iBAAiB,EACpC,eAAe,EAAE,aAAa,EAAE,EAChC,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,GAAG,IAAI,GACpC,WAAW,CAAC,IAAI,CAAC,CAoBnB;AAED,OAAO,EAAE,aAAa,EAAE,CAAA"}
+{"version":3,"file":"feedback-state.d.ts","sourceRoot":"","sources":["../../src/client/feedback-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAA;AAC9F,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAA;AAChG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2CAA2C,CAAA;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAA;AACrF,OAAO,KAAK,EACX,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,MAAM,6CAA6C,CAAA;AAapD,iBAAS,sBAAsB,CAAC,IAAI,SAAS,KAAK,EACjD,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,EACzB,IAAI,EAAE,YAAY,EAAE,EACpB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EACjC,WAAW,EAAE,mBAAmB,CAAC,IAAI,CAAC,EACtC,UAAU,EAAE,kBAAkB,CAAC,IAAI,CAAC,EACpC,iBAAiB,EAAE,iBAAiB,EACpC,eAAe,EAAE,aAAa,EAAE,EAChC,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,GAAG,IAAI,GACpC,WAAW,CAAC,IAAI,CAAC,CAcnB;AAED,iBAAS,qBAAqB,CAAC,IAAI,SAAS,KAAK,EAChD,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,EACzB,IAAI,EAAE,YAAY,EAAE,EACpB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EACjC,WAAW,EAAE,mBAAmB,CAAC,IAAI,CAAC,EACtC,eAAe,EAAE,aAAa,EAAE,GAC9B,WAAW,CAAC,IAAI,CAAC,CAWnB;AAED,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/client/index.d.ts

@@ -1,4 +1,4 @@
 export type { PrimerOptions, PrimerOptionsWithAccessToken, PrimerOptionsWithManagedAuth } from "./start";
 export { start } from "./start";
-export type { AccessTokenStartState, AssessmentOutcome, AssessmentOutcomeValue, AuthConfigInvalidState, AuthUnavailableState, ChoiceState, CompletedState, ErroredState, ExtendedTextMultipleState, ExtendedTextSingleState, ExtendedTextState, FatalState, FeedbackState, InteractionState, ManagedStartState, MatchState, NonRetriableErroredState, NonSerializable, ObservationState, OrderState, PciInteractionState, PciPendingRenderProps, PciRenderProps, PciSubmittedRenderProps, PrimerState, RetriableErroredState, RuntimeState, SignInFailedState, SignInRequiredState, TextEntryState } from "./types";
+export type { AccessTokenStartState, AssessmentOutcome, AssessmentOutcomeValue, AuthConfigInvalidState, AuthUnavailableState, ChoiceState, CompletedState, ErroredState, ExtendedTextMultipleState, ExtendedTextSingleState, ExtendedTextState, FatalState, FeedbackKind, FeedbackState, InteractionFeedback, InteractionState, ManagedStartState, MatchState, NonRetriableErroredState, NonSerializable, ObservationState, OrderState, PciInteractionState, PciPendingRenderProps, PciRenderProps, PciSubmittedRenderProps, PrimerState, RetriableErroredState, RuntimeState, SignInFailedState, SignInRequiredState, SubmittedFeedbackState, TextEntryState, TimedOutFeedbackState } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,aAAa,EACb,4BAA4B,EAC5B,4BAA4B,EAC5B,MAAM,0CAA0C,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,0CAA0C,CAAA;AAEhE,YAAY,EACX,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,uBAAuB,EACvB,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,MAAM,0CAA0C,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,aAAa,EACb,4BAA4B,EAC5B,4BAA4B,EAC5B,MAAM,0CAA0C,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,0CAA0C,CAAA;AAEhE,YAAY,EACX,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,uBAAuB,EACvB,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,MAAM,0CAA0C,CAAA"}

package/dist/client/index.js

@@ -6279,6 +6279,7 @@ var ErrAuthStateMismatch = errors.new("auth state mismatch");
 var ErrAuthPopupBlocked = errors.new("auth popup blocked");
 var ErrAuthCancelled = errors.new("auth cancelled");
 var ErrSdkUpgradeRequired = errors.new("sdk upgrade required");
+var ErrCurriculumInstructionalUndeliverable = errors.new("curriculum instructional undeliverable");
 // src/contracts/content.ts
 function inlinesToPlainText(nodes) {
   const parts = [];
@@ -6956,7 +6957,10 @@ function readPopupMessage(event, popup, config, expectedOrigin) {
   }
   return { kind: "success", accessToken };
 }
-async function waitForPopupMessage(popup, config, expectedOrigin) {
+function supportsAsyncDisposableStack() {
+  return typeof Reflect.get(globalThis, "AsyncDisposableStack") === "function";
+}
+async function waitForPopupMessageWithAsyncDisposableStack(popup, config, expectedOrigin) {
   let __stack = [];
   try {
     const logger = config.logger;
@@ -7023,6 +7027,86 @@ async function waitForPopupMessage(popup, config, expectedOrigin) {
     _promise && await _promise;
   }
 }
+function cleanupManualPopupWait(cleanups) {
+  for (let index = cleanups.length - 1;index >= 0; index -= 1) {
+    const cleanup = cleanups[index];
+    if (cleanup === undefined) {
+      continue;
+    }
+    cleanup();
+  }
+}
+async function waitForPopupMessageWithManualCleanup(popup, config, expectedOrigin) {
+  const logger = config.logger;
+  const cleanups = [];
+  cleanups.push(function closePopup() {
+    popup.close();
+  });
+  const pending = new Promise(function waitForMessage(resolve, reject) {
+    let settled = false;
+    function finishWithError(error) {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      reject(error);
+    }
+    function finishWithToken(token) {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      logger.debug("hosted auth popup completed");
+      resolve(token);
+    }
+    const timeoutId = globalThis.setTimeout(function timeout() {
+      logger.error("hosted auth popup timed out");
+      finishWithError(ErrAuthCancelled);
+    }, DEFAULT_POPUP_TIMEOUT_MS);
+    cleanups.push(function clearPopupTimeout() {
+      globalThis.clearTimeout(timeoutId);
+    });
+    const closedPollId = globalThis.setInterval(function checkClosed() {
+      if (!popup.closed) {
+        return;
+      }
+      logger.error("hosted auth popup closed");
+      finishWithError(ErrAuthCancelled);
+    }, POPUP_POLL_MS);
+    cleanups.push(function clearClosedPoll() {
+      globalThis.clearInterval(closedPollId);
+    });
+    function handleMessage(event) {
+      const result = readPopupMessage(event, popup, config, expectedOrigin);
+      if (result.kind === "ignore") {
+        return;
+      }
+      if (result.kind === "error") {
+        logger.error({ error: result.error }, "hosted auth popup failed");
+        finishWithError(result.error);
+        return;
+      }
+      finishWithToken(result.accessToken);
+    }
+    globalThis.addEventListener("message", handleMessage);
+    cleanups.push(function removeMessageListener() {
+      globalThis.removeEventListener("message", handleMessage);
+    });
+  });
+  return pending.then(function cleanupSuccess(token) {
+    cleanupManualPopupWait(cleanups);
+    return token;
+  }, function cleanupFailure(error) {
+    cleanupManualPopupWait(cleanups);
+    throw error;
+  });
+}
+async function waitForPopupMessage(popup, config, expectedOrigin) {
+  if (supportsAsyncDisposableStack()) {
+    return waitForPopupMessageWithAsyncDisposableStack(popup, config, expectedOrigin);
+  }
+  return waitForPopupMessageWithManualCleanup(popup, config, expectedOrigin);
+}
 async function beginHostedPopup(config) {
   const logger = config.logger;
   const url = hostedAuthUrl(config);
@@ -7207,7 +7291,7 @@ import * as errors11 from "@superbuilders/errors";
 
 // src/client/choice-state.ts
 import * as errors5 from "@superbuilders/errors";
-function choiceState(ctx, body, stimulus, interaction, options, maxChoices, minChoices) {
+function choiceState(ctx, body, stimulus, interaction, options, maxChoices, minChoices, feedback) {
   let submitPending;
   let submitKey;
   let timeoutPending;
@@ -7254,6 +7338,7 @@ function choiceState(ctx, body, stimulus, interaction, options, maxChoices, minC
     body,
     stimulus,
     interaction,
+    feedback,
     options,
     maxChoices,
     minChoices,
@@ -7265,7 +7350,7 @@ function choiceState(ctx, body, stimulus, interaction, options, maxChoices, minC
 
 // src/client/extended-text-state.ts
 import * as errors6 from "@superbuilders/errors";
-function extendedTextState(ctx, body, stimulus, interaction) {
+function extendedTextState(ctx, body, stimulus, interaction, feedback) {
   if (interaction.cardinality === "single") {
     let submitText = function(value) {
       const submission = { type: "extended-text", values: [value] };
@@ -7313,6 +7398,7 @@ function extendedTextState(ctx, body, stimulus, interaction) {
       body,
       stimulus,
       interaction,
+      feedback,
       submitText,
       timeout: timeout2,
       toJSON: poisonToJSON
@@ -7366,6 +7452,7 @@ function extendedTextState(ctx, body, stimulus, interaction) {
     body,
     stimulus,
     interaction: multi,
+    feedback,
     maxStrings: multi.maxStrings,
     minStrings: multi.minStrings,
     submitTexts,
@@ -7375,10 +7462,20 @@ function extendedTextState(ctx, body, stimulus, interaction) {
 }
 
 // src/client/feedback-state.ts
-function feedbackState(ctx, body, stimulus, interaction, submission, assessmentOutcome, feedbackContent, review) {
+function createAdvance(ctx) {
   let pending;
+  return function advance() {
+    if (pending) {
+      return pending;
+    }
+    pending = ctx.execute({ kind: "observation" }, "observation");
+    return pending;
+  };
+}
+function submittedFeedbackState(ctx, body, stimulus, interaction, submission, assessmentOutcome, feedbackContent, review) {
   return {
     phase: "feedback",
+    feedbackKind: "submitted",
     body,
     stimulus,
     interaction,
@@ -7386,20 +7483,26 @@ function feedbackState(ctx, body, stimulus, interaction, submission, assessmentO
     assessmentOutcome,
     feedbackContent,
     review,
-    advance: function advance() {
-      if (pending) {
-        return pending;
-      }
-      pending = ctx.execute({ kind: "observation" }, "observation");
-      return pending;
-    },
+    advance: createAdvance(ctx),
+    toJSON: poisonToJSON
+  };
+}
+function timedOutFeedbackState(ctx, body, stimulus, interaction, feedbackContent) {
+  return {
+    phase: "feedback",
+    feedbackKind: "timedOut",
+    body,
+    stimulus,
+    interaction,
+    feedbackContent,
+    advance: createAdvance(ctx),
     toJSON: poisonToJSON
   };
 }
 
 // src/client/match-state.ts
 import * as errors7 from "@superbuilders/errors";
-function matchState(ctx, body, stimulus, interaction) {
+function matchState(ctx, body, stimulus, interaction, feedback) {
   let submitPending;
   let submitKey;
   let timeoutPending;
@@ -7446,6 +7549,7 @@ function matchState(ctx, body, stimulus, interaction) {
     body,
     stimulus,
     interaction,
+    feedback,
     sourceChoices: interaction.sourceChoices,
     targetChoices: interaction.targetChoices,
     minAssociations: interaction.minAssociations,
@@ -7476,7 +7580,7 @@ function observationState(ctx, body, stimulus) {
 
 // src/client/order-state.ts
 import * as errors8 from "@superbuilders/errors";
-function orderState(ctx, body, stimulus, interaction) {
+function orderState(ctx, body, stimulus, interaction, feedback) {
   let submitPending;
   let submitKey;
   let timeoutPending;
@@ -7523,6 +7627,7 @@ function orderState(ctx, body, stimulus, interaction) {
     body,
     stimulus,
     interaction,
+    feedback,
     choices: interaction.choices,
     minChoices: interaction.minChoices,
     maxChoices: interaction.maxChoices,
@@ -7534,7 +7639,7 @@ function orderState(ctx, body, stimulus, interaction) {
 
 // src/client/pci-state.ts
 import * as errors9 from "@superbuilders/errors";
-function pciInteractionState(ctx, body, stimulus, interaction) {
+function pciInteractionState(ctx, body, stimulus, interaction, feedback) {
   let submitPending;
   let submitKey;
   let timeoutPending;
@@ -7579,6 +7684,7 @@ function pciInteractionState(ctx, body, stimulus, interaction) {
     body,
     stimulus,
     interaction,
+    feedback,
     pciId,
     properties,
     submit,
@@ -7589,7 +7695,7 @@ function pciInteractionState(ctx, body, stimulus, interaction) {
 
 // src/client/text-entry-state.ts
 import * as errors10 from "@superbuilders/errors";
-function textEntryState(ctx, body, stimulus, interaction) {
+function textEntryState(ctx, body, stimulus, interaction, feedback) {
   let submitPending;
   let submitKey;
   let timeoutPending;
@@ -7636,6 +7742,7 @@ function textEntryState(ctx, body, stimulus, interaction) {
     body,
     stimulus,
     interaction,
+    feedback,
     submitText,
     timeout,
     toJSON: poisonToJSON
@@ -7645,6 +7752,7 @@ function textEntryState(ctx, body, stimulus, interaction) {
 // src/client/session.ts
 var FATAL_SENTINELS = [
   ErrBadRequest,
+  ErrCurriculumInstructionalUndeliverable,
   ErrInvalidAccessToken,
   ErrTokenExpired,
   ErrForbidden,
@@ -7668,7 +7776,7 @@ function makeSession(sc) {
   function resolve(result) {
     switch (result.outcome) {
       case "advanced":
-        return fromAdvanced(result.frame.body, result.frame.stimulus, result.frame.interaction);
+        return fromAdvanced(result.frame.body, result.frame.stimulus, result.frame.interaction, result.frame.feedback);
       case "submitted": {
         const interaction = result.frame.interaction;
         if (interaction === null) {
@@ -7681,9 +7789,26 @@ function makeSession(sc) {
           };
         }
         if (result.assessmentOutcome.value === "revisionRequested") {
-          return fromAdvanced(result.frame.body, result.frame.stimulus, interaction);
+          const feedback = {
+            assessmentOutcome: result.assessmentOutcome,
+            feedbackContent: result.feedbackContent
+          };
+          return fromAdvanced(result.frame.body, result.frame.stimulus, interaction, feedback);
+        }
+        return submittedFeedbackState(ctx, result.frame.body, result.frame.stimulus, interaction, result.submission, result.assessmentOutcome, result.feedbackContent, result.review);
+      }
+      case "timedOut": {
+        const interaction = result.frame.interaction;
+        if (interaction === null) {
+          logger.error("timed out result without interaction");
+          return {
+            phase: "fatal",
+            error: errors11.wrap(ErrBadRequest, "timed out result missing interaction"),
+            retriable: false,
+            toJSON: poisonToJSON
+          };
         }
-        return feedbackState(ctx, result.frame.body, result.frame.stimulus, interaction, result.submission, result.assessmentOutcome, result.feedbackContent, result.review);
+        return timedOutFeedbackState(ctx, result.frame.body, result.frame.stimulus, interaction, result.feedbackContent);
       }
       case "completed":
         return { phase: "completed", toJSON: poisonToJSON };
@@ -7769,7 +7894,7 @@ function makeSession(sc) {
     }
     return false;
   }
-  function fromAdvanced(body, stimulus, interaction) {
+  function fromAdvanced(body, stimulus, interaction, feedback) {
     if (interaction === null) {
       return observationState(ctx, body, stimulus);
     }
@@ -7784,9 +7909,9 @@ function makeSession(sc) {
         };
       }
     }
-    return pendingInteractionState(body, stimulus, interaction);
+    return pendingInteractionState(body, stimulus, interaction, feedback);
   }
-  function extendedTextInteractionState(body, stimulus, interaction) {
+  function extendedTextInteractionState(body, stimulus, interaction, feedback) {
     if (!("cardinality" in interaction)) {
       logger.error("extended-text interaction is unsupported");
       return {
@@ -7797,22 +7922,22 @@ function makeSession(sc) {
       };
     }
     const extendedInteraction = interaction;
-    return extendedTextState(ctx, body, stimulus, extendedInteraction);
+    return extendedTextState(ctx, body, stimulus, extendedInteraction, feedback);
   }
-  function pendingInteractionState(body, stimulus, interaction) {
+  function pendingInteractionState(body, stimulus, interaction, feedback) {
     switch (interaction.type) {
       case "choice":
-        return choiceState(ctx, body, stimulus, interaction, interaction.options, interaction.maxChoices, interaction.minChoices);
+        return choiceState(ctx, body, stimulus, interaction, interaction.options, interaction.maxChoices, interaction.minChoices, feedback);
       case "text-entry":
-        return textEntryState(ctx, body, stimulus, interaction);
+        return textEntryState(ctx, body, stimulus, interaction, feedback);
       case "extended-text":
-        return extendedTextInteractionState(body, stimulus, interaction);
+        return extendedTextInteractionState(body, stimulus, interaction, feedback);
       case "order":
-        return orderState(ctx, body, stimulus, interaction);
+        return orderState(ctx, body, stimulus, interaction, feedback);
       case "match":
-        return matchState(ctx, body, stimulus, interaction);
+        return matchState(ctx, body, stimulus, interaction, feedback);
       case "portable-custom":
-        return pciInteractionState(ctx, body, stimulus, interaction);
+        return pciInteractionState(ctx, body, stimulus, interaction, feedback);
     }
   }
   const ctx = { logger, execute, errored };
@@ -7823,7 +7948,7 @@ function makeSession(sc) {
 import * as errors12 from "@superbuilders/errors";
 
 // src/version.ts
-var SDK_VERSION = "4.1.0";
+var SDK_VERSION = "5.0.0";
 var NPM_PACKAGE_URL = "https://www.npmjs.com/package/@superbuilders/primer-tives";
 
 // src/client/transport.ts
@@ -7881,6 +8006,9 @@ function httpSentinel(status, body) {
     if (parsed?.error === "sdk_upgrade_required") {
       return ErrSdkUpgradeRequired;
     }
+    if (parsed?.error === "curriculum_instructional_undeliverable") {
+      return ErrCurriculumInstructionalUndeliverable;
+    }
     return ErrBadRequest;
   }
   if (status === 401) {
@@ -8039,6 +8167,12 @@ function primerOrigin(origin) {
   }
   return DEFAULT_PRIMER_ORIGIN;
 }
+function primerAuthOrigin(authOrigin, origin) {
+  if (authOrigin !== undefined) {
+    return authOrigin;
+  }
+  return origin;
+}
 async function startRuntime(config, resolved) {
   let reauthenticate = null;
   if (resolved.clearCachedAccessToken !== undefined) {
@@ -8082,7 +8216,7 @@ function makeSignInFailedState(config, error) {
 }
 async function loginAndStart(config) {
   const result = await beginHostedLogin({
-    origin: config.origin,
+    origin: config.authOrigin,
     publishableKey: config.publishableKey,
     logger: config.logger
   });
@@ -8107,6 +8241,7 @@ async function start(options) {
   const config = {
     publishableKey: options.publishableKey,
     origin,
+    authOrigin: primerAuthOrigin(options.authOrigin, origin),
     fetch: options.fetch,
     abort: options.abort,
     logger,
@@ -8139,4 +8274,4 @@ export {
   start
 };
 
-//# debugId=8BB175F09E303E4A64756E2164756E21
+//# debugId=5F7821132D289BDA64756E2164756E21