@foir/sdk 0.25.0 → 0.27.0

package/dist/transport/foir-http.d.ts

@@ -55,7 +55,14 @@ export declare function resolveFoirApiKey(env: FoirEnv): string | undefined;
  * because an absent record is an answer rather than a failure. `NOT_FOUND` only
  * appears when a mutation names something that does not exist.
  */
-export type FoirErrorCode = 'INVALID_ARGUMENT' | 'NOT_FOUND' | 'ALREADY_EXISTS' | 'FAILED_PRECONDITION' | 'PERMISSION_DENIED' | 'UNAUTHENTICATED' | 'RATE_LIMITED' | 'TIMEOUT' | 'UNAVAILABLE' | 'CANCELED' | 'INTERNAL';
+export type FoirErrorCode = 'INVALID_ARGUMENT' | 'NOT_FOUND' | 'ALREADY_EXISTS' | 'FAILED_PRECONDITION' | 'PERMISSION_DENIED' | 'UNAUTHENTICATED' | 'RATE_LIMITED' | 'TIMEOUT' | 'UNAVAILABLE' | 'CANCELED' | 'INTERNAL' | 'STEP_UP_REQUIRED';
+/**
+ * What a `STEP_UP_REQUIRED` refusal asks of the signed-in user, in
+ * `extensions.stepUp`: `second_factor`, prove a second factor (the step-up
+ * flow) and retry; `sign_in_method`, sign in again with a method the
+ * organization the request stands in accepts.
+ */
+export type FoirStepUp = 'second_factor' | 'sign_in_method';
 export interface FoirErrorExtensions {
     /** Stable machine-readable code. Branch on this, never on `message`. */
     code?: FoirErrorCode | string;
@@ -63,6 +70,8 @@ export interface FoirErrorExtensions {
     requestId?: string;
     /** On `RATE_LIMITED`: whole seconds to wait. Never less than 1. */
     retryAfter?: number;
+    /** On `STEP_UP_REQUIRED`: what the signed-in user must do before retrying. */
+    stepUp?: FoirStepUp;
     [key: string]: unknown;
 }
 export interface FoirGraphQLErrorItem {
@@ -115,6 +124,13 @@ export interface FoirRateLimitSnapshot {
     /** Unix seconds at which the window resets. */
     resetAt: number;
 }
+/**
+ * What an error asks of the signed-in user before the request can succeed, or
+ * null: an organization's sign-in rules turned the session away, because it
+ * requires a second factor the session has not proven (`second_factor`) or does
+ * not accept how the user signed in (`sign_in_method`).
+ */
+export declare function stepUpRequired(error: unknown): FoirStepUp | null;
 export declare class FoirRequestError extends Error {
     /** HTTP status code, when the request failed at the HTTP layer. */
     readonly status?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foir/sdk",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "description": "Official Foir SDK — editor iframe client + server-side platform helpers",
   "type": "module",
   "publishConfig": {
@@ -168,7 +168,7 @@
     "blurhash": "^2.0.5",
     "graphql": "^16.10.0",
     "hls.js": "^1.6.16",
-    "jsdom": "^27.0.0",
+    "jsdom": "^28.1.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "tsup": "^8.5.1",