@superbuilders/primer-tives 5.0.1 → 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
 
@@ -899,6 +899,7 @@ Fatal sentinels:
 | --- | --- |
 | `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. |
@@ -1278,17 +1279,21 @@ import {
 	ErrConflict,
 	ErrCurriculumInstructionalUndeliverable,
 	ErrForbidden,
+	ErrFrameAlreadyAnswered,
 	ErrInvalidAccessToken,
 	ErrInvalidSubmission,
 	ErrJsonParse,
 	ErrMalformedAccessToken,
 	ErrNetwork,
+	ErrNoActiveFrame,
+	ErrNoRoutableContent,
 	ErrNotFound,
 	ErrNotSerializable,
 	ErrRateLimited,
 	ErrSdkUpgradeRequired,
 	ErrServerError,
 	ErrServiceUnavailable,
+	ErrSessionStateConflict,
 	ErrTimeout,
 	ErrTokenExpired,
 	ErrUnsupportedPci
@@ -1321,10 +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. |

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

@@ -6280,6 +6280,10 @@ 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 = [];
@@ -7757,9 +7761,19 @@ var FATAL_SENTINELS = [
   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)) {
@@ -7769,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;
@@ -7815,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 {
@@ -7825,6 +7861,7 @@ function makeSession(sc) {
         toJSON: poisonToJSON
       };
     }
+    let pending;
     const state = {
       phase: "errored",
       error,
@@ -7948,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
@@ -8000,40 +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;
-    }
-    if (parsed?.error === "curriculum_instructional_undeliverable") {
-      return ErrCurriculumInstructionalUndeliverable;
-    }
-    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);
@@ -8274,4 +8332,4 @@ export {
   start
 };
 
-//# debugId=5F7821132D289BDA64756E2164756E21
+//# debugId=437ED91D306035DE64756E2164756E21