@superbuilders/primer-tives 5.0.0 → 5.0.2

package/README.md

@@ -19,7 +19,7 @@ bun add @superbuilders/primer-tives
 
 ## Version
 
-The current SDK version is `5.0.0`.
+The current SDK version is `5.0.2`.
 
 ## Entrypoints
 
@@ -898,6 +898,8 @@ 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. |
+| `ErrNoRoutableContent` | The catalog has no routable bootstrap content for the learner's scope. |
 | `ErrInvalidAccessToken` | The learner token was rejected. |
 | `ErrTokenExpired` | The learner token expired. |
 | `ErrForbidden` | The learner is not allowed to continue in this runtime scope. |
@@ -1275,18 +1277,23 @@ import {
 	ErrAuthUnavailable,
 	ErrBadRequest,
 	ErrConflict,
+	ErrCurriculumInstructionalUndeliverable,
 	ErrForbidden,
+	ErrFrameAlreadyAnswered,
 	ErrInvalidAccessToken,
 	ErrInvalidSubmission,
 	ErrJsonParse,
 	ErrMalformedAccessToken,
 	ErrNetwork,
+	ErrNoActiveFrame,
+	ErrNoRoutableContent,
 	ErrNotFound,
 	ErrNotSerializable,
 	ErrRateLimited,
 	ErrSdkUpgradeRequired,
 	ErrServerError,
 	ErrServiceUnavailable,
+	ErrSessionStateConflict,
 	ErrTimeout,
 	ErrTokenExpired,
 	ErrUnsupportedPci
@@ -1319,9 +1326,14 @@ Runtime errors are represented as `ErroredState` or `FatalState`.
 | `ErrServiceUnavailable` | `ErroredState` | yes | Primer is temporarily unavailable. |
 | `ErrRateLimited` | `ErroredState` | yes | Runtime work is temporarily rate limited. |
 | `ErrConflict` | `ErroredState` | yes | The learner intent conflicts with another in-flight or current runtime action. |
+| `ErrNoActiveFrame` | `ResyncableErroredState` | no | Primer has no open frame for the submitted intent; call `resync()` to realign. |
+| `ErrFrameAlreadyAnswered` | `ResyncableErroredState` | no | The targeted frame was already answered; call `resync()` to realign. |
+| `ErrSessionStateConflict` | `ResyncableErroredState` | no | The learner intent does not match the active frame type; call `resync()` to realign. |
 | `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. |
+| `ErrNoRoutableContent` | `FatalState` | no | Catalog bootstrap has no routable content for the learner scope. |
 | `ErrInvalidAccessToken` | `FatalState` | no | Learner token is invalid. |
 | `ErrTokenExpired` | `FatalState` | no | Learner token expired. |
 | `ErrForbidden` | `FatalState` | no | Learner cannot continue in this runtime scope. |
@@ -1389,6 +1401,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
 }
@@ -1462,6 +1478,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/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, FeedbackKind, FeedbackState, InteractionFeedback, InteractionState, ManagedStartState, MatchState, NonRetriableErroredState, NonSerializable, ObservationState, OrderState, PciInteractionState, PciPendingRenderProps, PciRenderProps, PciSubmittedRenderProps, PrimerState, RetriableErroredState, RuntimeState, SignInFailedState, SignInRequiredState, SubmittedFeedbackState, TextEntryState, TimedOutFeedbackState } 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, ResyncableErroredState, 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,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"}
+{"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,sBAAsB,EACtB,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,11 @@ 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");
+var ErrNoRoutableContent = errors.new("no routable content");
+var ErrNoActiveFrame = errors.new("no active frame");
+var ErrFrameAlreadyAnswered = errors.new("frame already answered");
+var ErrSessionStateConflict = errors.new("session state conflict");
 // src/contracts/content.ts
 function inlinesToPlainText(nodes) {
   const parts = [];
@@ -7751,13 +7756,24 @@ function textEntryState(ctx, body, stimulus, interaction, feedback) {
 // src/client/session.ts
 var FATAL_SENTINELS = [
   ErrBadRequest,
+  ErrCurriculumInstructionalUndeliverable,
   ErrInvalidAccessToken,
   ErrTokenExpired,
   ErrForbidden,
   ErrNotFound,
+  ErrNoRoutableContent,
   ErrSdkUpgradeRequired,
   ErrUnsupportedPci
 ];
+var SESSION_SYNC_SENTINELS = [ErrNoActiveFrame, ErrFrameAlreadyAnswered, ErrSessionStateConflict];
+function isSessionSyncError(err) {
+  for (const sentinel of SESSION_SYNC_SENTINELS) {
+    if (errors11.is(err, sentinel)) {
+      return true;
+    }
+  }
+  return false;
+}
 function isFatalError(err) {
   for (const sentinel of FATAL_SENTINELS) {
     if (errors11.is(err, sentinel)) {
@@ -7767,7 +7783,13 @@ function isFatalError(err) {
   return false;
 }
 function isRetriableError(err) {
-  return !errors11.is(err, ErrInvalidSubmission);
+  if (errors11.is(err, ErrInvalidSubmission)) {
+    return false;
+  }
+  if (isSessionSyncError(err)) {
+    return false;
+  }
+  return true;
 }
 function makeSession(sc) {
   const logger = sc.logger;
@@ -7813,7 +7835,23 @@ function makeSession(sc) {
     }
   }
   function errored(error, failedPhase, intent) {
-    let pending;
+    if (isSessionSyncError(error)) {
+      let pending2;
+      return {
+        phase: "errored",
+        error,
+        retriable: false,
+        resync: function resync() {
+          if (pending2) {
+            return pending2;
+          }
+          logger.debug({ failedPhase }, "resyncing session from errored state");
+          pending2 = execute({ kind: "observation" }, "observation");
+          return pending2;
+        },
+        toJSON: poisonToJSON
+      };
+    }
     const retriable = isRetriableError(error);
     if (!retriable) {
       return {
@@ -7823,6 +7861,7 @@ function makeSession(sc) {
         toJSON: poisonToJSON
       };
     }
+    let pending;
     const state = {
       phase: "errored",
       error,
@@ -7946,7 +7985,7 @@ function makeSession(sc) {
 import * as errors12 from "@superbuilders/errors";
 
 // src/version.ts
-var SDK_VERSION = "5.0.0";
+var SDK_VERSION = "5.0.2";
 var NPM_PACKAGE_URL = "https://www.npmjs.com/package/@superbuilders/primer-tives";
 
 // src/client/transport.ts
@@ -7998,37 +8037,61 @@ function parseAdvanceErrorBody(body) {
   }
   return result;
 }
-function httpSentinel(status, body) {
-  if (status === 400) {
-    const parsed = parseAdvanceErrorBody(body);
-    if (parsed?.error === "sdk_upgrade_required") {
-      return ErrSdkUpgradeRequired;
-    }
-    return ErrBadRequest;
-  }
-  if (status === 401) {
-    const parsed = parseAdvanceErrorBody(body);
-    if (parsed?.detail === "token_expired") {
-      return ErrTokenExpired;
+var ADVANCE_400_ERRORS = {
+  sdk_upgrade_required: ErrSdkUpgradeRequired,
+  curriculum_instructional_undeliverable: ErrCurriculumInstructionalUndeliverable,
+  no_routable_content: ErrNoRoutableContent
+};
+var ADVANCE_409_ERRORS = {
+  no_active_frame: ErrNoActiveFrame,
+  frame_already_answered: ErrFrameAlreadyAnswered,
+  session_state_conflict: ErrSessionStateConflict
+};
+function advanceErrorSentinel(errorCode, mapping, fallback) {
+  if (errorCode !== undefined) {
+    const sentinel = mapping[errorCode];
+    if (sentinel !== undefined) {
+      return sentinel;
     }
-    return ErrInvalidAccessToken;
   }
-  if (status === 403) {
-    return ErrForbidden;
-  }
-  if (status === 404) {
-    return ErrNotFound;
-  }
-  if (status === 409) {
-    return ErrConflict;
-  }
-  if (status === 429) {
-    return ErrRateLimited;
+  return fallback;
+}
+function badRequestSentinel(body) {
+  const parsed = parseAdvanceErrorBody(body);
+  return advanceErrorSentinel(parsed?.error, ADVANCE_400_ERRORS, ErrBadRequest);
+}
+function unauthorizedSentinel(body) {
+  const parsed = parseAdvanceErrorBody(body);
+  if (parsed?.detail === "token_expired") {
+    return ErrTokenExpired;
   }
-  if (status === 502 || status === 503 || status === 504) {
-    return ErrServiceUnavailable;
+  return ErrInvalidAccessToken;
+}
+function conflictSentinel(body) {
+  const parsed = parseAdvanceErrorBody(body);
+  return advanceErrorSentinel(parsed?.error, ADVANCE_409_ERRORS, ErrConflict);
+}
+function httpSentinel(status, body) {
+  switch (status) {
+    case 400:
+      return badRequestSentinel(body);
+    case 401:
+      return unauthorizedSentinel(body);
+    case 403:
+      return ErrForbidden;
+    case 404:
+      return ErrNotFound;
+    case 409:
+      return conflictSentinel(body);
+    case 429:
+      return ErrRateLimited;
+    case 502:
+    case 503:
+    case 504:
+      return ErrServiceUnavailable;
+    default:
+      return ErrServerError;
   }
-  return ErrServerError;
 }
 function buildSdkUpgradeRequiredError(sentinel, text, logger) {
   const parsed = parseAdvanceErrorBody(text);
@@ -8269,4 +8332,4 @@ export {
   start
 };
 
-//# debugId=9849F045A465657964756E2164756E21
+//# debugId=437ED91D306035DE64756E2164756E21