@edpire/sdk 0.6.12 → 0.7.0

package/dist/client.d.mts

@@ -225,23 +225,6 @@ interface Submission {
         result: unknown;
     }>;
 }
-interface Collection {
-    id: string;
-    name: string;
-    slug: string;
-    description: string | null;
-    status: string;
-    item_count: number;
-    created_at: string;
-    updated_at: string;
-}
-interface CollectionDetail extends Collection {
-    items: Array<{
-        id: string;
-        position: number;
-        assessment: Assessment;
-    }>;
-}
 interface Webhook {
     id: string;
     url: string;
@@ -375,39 +358,6 @@ declare class EdpireClient {
         page?: number;
         limit?: number;
     }): Promise<PaginatedResponse<Submission>>;
-    /**
-     * List collections in your org.
-     *
-     * @param params.page - Page number (default 1).
-     * @param params.limit - Items per page (default 20, max 100).
-     * @returns Paginated list of collections with item counts.
-     */
-    getCollections(params?: {
-        page?: number;
-        limit?: number;
-    }): Promise<PaginatedResponse<Collection>>;
-    /**
-     * Fetch a collection with its assessment items.
-     *
-     * @param id - Collection UUID.
-     * @returns Collection detail with ordered assessment items.
-     * @throws {EdpireError} 404 if not found.
-     */
-    getCollection(id: string): Promise<CollectionDetail>;
-    /**
-     * Fetch aggregated results across all assessments in a collection.
-     *
-     * @param id - Collection UUID.
-     * @param params.page - Page number (default 1).
-     * @param params.limit - Items per page (default 50, max 100).
-     * @returns Paginated flat list of submissions with assessment titles.
-     */
-    getCollectionResults(id: string, params?: {
-        page?: number;
-        limit?: number;
-    }): Promise<PaginatedResponse<Submission & {
-        assessment_title: string;
-    }>>;
     /**
      * Register a webhook endpoint.
      *
@@ -578,4 +528,4 @@ declare function createEdpireTokenHandler(opts: EdpireTokenHandlerOptions): (req
  */
 declare function toNodeHandler(handler: (req: Request) => Promise<Response>): (req: ConnectRequest, res: ConnectResponse) => void;
 
-export { type Assessment, type AssessmentExercise, type AssessmentQuestion, type AssessmentSummary, type CheckOptions, type CheckResult, type Collection, type CollectionDetail, EdpireClient, type EdpireClientOptions, EdpireError, type EdpireTokenHandlerOptions, type EmbedToken, type GradeResult, type PaginatedResponse, type StoredAnswer, type Submission, type SubmitOptions, type Webhook, type WebhookWithSecret, createEdpireTokenHandler, toNodeHandler };
+export { type Assessment, type AssessmentExercise, type AssessmentQuestion, type AssessmentSummary, type CheckOptions, type CheckResult, EdpireClient, type EdpireClientOptions, EdpireError, type EdpireTokenHandlerOptions, type EmbedToken, type GradeResult, type PaginatedResponse, type StoredAnswer, type Submission, type SubmitOptions, type Webhook, type WebhookWithSecret, createEdpireTokenHandler, toNodeHandler };

package/dist/client.mjs

@@ -201,46 +201,6 @@ var EdpireClient = class {
       `/learners/${encodeURIComponent(learnerRef)}/results?${query.toString()}`
     );
   }
-  // ── Collections ────────────────────────────────────────────────────────
-  /**
-   * List collections in your org.
-   *
-   * @param params.page - Page number (default 1).
-   * @param params.limit - Items per page (default 20, max 100).
-   * @returns Paginated list of collections with item counts.
-   */
-  async getCollections(params) {
-    const query = new URLSearchParams();
-    if (params?.page) query.set("page", String(params.page));
-    if (params?.limit) query.set("limit", String(params.limit));
-    const qs = query.toString();
-    return this.requestPaginated("GET", `/collections${qs ? `?${qs}` : ""}`);
-  }
-  /**
-   * Fetch a collection with its assessment items.
-   *
-   * @param id - Collection UUID.
-   * @returns Collection detail with ordered assessment items.
-   * @throws {EdpireError} 404 if not found.
-   */
-  async getCollection(id) {
-    return this.request("GET", `/collections/${id}`);
-  }
-  /**
-   * Fetch aggregated results across all assessments in a collection.
-   *
-   * @param id - Collection UUID.
-   * @param params.page - Page number (default 1).
-   * @param params.limit - Items per page (default 50, max 100).
-   * @returns Paginated flat list of submissions with assessment titles.
-   */
-  async getCollectionResults(id, params) {
-    const query = new URLSearchParams();
-    if (params?.page) query.set("page", String(params.page));
-    if (params?.limit) query.set("limit", String(params.limit));
-    const qs = query.toString();
-    return this.requestPaginated("GET", `/collections/${id}/results${qs ? `?${qs}` : ""}`);
-  }
   // ── Webhooks ───────────────────────────────────────────────────────────
   /**
    * Register a webhook endpoint.

package/dist/core.d.mts

@@ -146,4 +146,38 @@ interface FlatStep {
  */
 declare function flattenAssessment(assessment: Assessment): FlatStep[];
 
-export { type FlatStep, type StoredAnswer, buildSubmitPayload, flattenAssessment };
+/**
+ * "Did the learner actually answer this?"
+ *
+ * Used to warn before submit when questions are left blank. The whole module
+ * exists because the obvious implementation is wrong: every player emits a
+ * RuntimeAnswer on mount, so a freshly-opened assessment already reports one
+ * answer per node. A typed blank emits `{ mode: "typed", text: "" }`, a choice
+ * set emits `{ selectedIds: [] }`. Counting answers would report every
+ * assessment fully answered and the warning would never fire.
+ *
+ * The expected node count comes from the content AST, never from `answerKeys`.
+ * A learner-facing payload ships `answerKeys: []` on purpose (see
+ * `getAssessmentForTaking`), so a key-based count works in the builder preview
+ * and silently never fires for a real learner, which is the worst of both.
+ */
+
+/**
+ * True when this answer carries something the learner actually supplied.
+ *
+ * The `switch` is exhaustive over RuntimeAnswer so adding a variant upstream
+ * fails the build here rather than silently defaulting. The runtime fallback is
+ * still `true`: a variant we do not recognise should not make the learner sit
+ * through a warning they cannot clear, because a warning that cries wolf gets
+ * clicked through and stops protecting anyone.
+ */
+declare function isAnswered(answer: RuntimeAnswer): boolean;
+/**
+ * How many inputs this question's content AST presents to the learner.
+ *
+ * Walks the tree rather than the top level: blanks are inline inside
+ * paragraphs, and any node can sit inside a table cell or blockquote.
+ */
+declare function countAnswerableNodes(content: unknown): number;
+
+export { type FlatStep, type StoredAnswer, buildSubmitPayload, countAnswerableNodes, flattenAssessment, isAnswered };

package/dist/core.mjs

@@ -1 +1 @@
-function i(r){let s=[],e=0;for(let t of r.exercises)for(let n of t.questions)s.push({exerciseId:t.id,questionId:n.id,content:n.content_ast,points:n.points,sequenceNumber:n.sequence_number,index:e++});return s}function o(r){let s=new Map;for(let e of r)s.has(e.exerciseId)||s.set(e.exerciseId,[]),s.get(e.exerciseId).push({questionId:e.questionId,answers:e.answers});return{exerciseAnswers:Array.from(s.entries()).map(([e,t])=>({exerciseId:e,questionAnswers:t}))}}export{o as buildSubmitPayload,i as flattenAssessment};
+function c(e){let n=[],t=0;for(let s of e.exercises)for(let r of s.questions)n.push({exerciseId:s.id,questionId:r.id,content:r.content_ast,points:r.points,sequenceNumber:r.sequence_number,index:t++});return n}function u(e){let n=new Map;for(let t of e)n.has(t.exerciseId)||n.set(t.exerciseId,[]),n.get(t.exerciseId).push({questionId:t.questionId,answers:t.answers});return{exerciseAnswers:Array.from(n.entries()).map(([t,s])=>({exerciseId:t,questionAnswers:s}))}}var a=new Set(["choiceSet","inlineChoiceSet","blank","aiAnswerInput","matchingSet","openResponseNode","mathResponse","codingResponse"]),f=new Set(["blankPool","inlinePool"]);function d(e){switch(e.type){case"choiceSet":case"inlineChoiceSet":return e.answer.selectedIds.length>0;case"blank":return e.answer.mode==="choice"?e.answer.choiceId.length>0:e.answer.text.trim().length>0;case"matchingSet":return e.answer.connections.length>0;case"aiAnswer":return e.answer.text.trim().length>0;case"openResponse":{let n=e.answer;return n.recording||n.files&&n.files.length>0?!0:(n.text?.wordCount??0)>0}case"mathResponse":return e.answer.latex.trim().length>0;case"codingResponse":return e.answer.source.trim().length>0;default:{let n=e;return!0}}}function m(e){let n=0,t=s=>{if(Array.isArray(s)){for(let i of s)t(i);return}if(!s||typeof s!="object")return;let{type:r,content:o}=s;if(typeof r=="string"){if(a.has(r)){n+=1;return}if(f.has(r))return}o!==void 0&&t(o)};return t(e),n}export{u as buildSubmitPayload,m as countAnswerableNodes,c as flattenAssessment,d as isAnswered};

package/dist/index.d.mts

@@ -30,6 +30,28 @@ interface TakeBranding {
         showPoweredBy?: boolean;
     } | null;
 }
+/**
+ * Geometry of the question column. Branding covers colour and type; this covers
+ * the one thing branding could not reach.
+ */
+interface ShellLayout {
+    /**
+     * Max width of the question column. Any CSS length, or `"none"` to fill the
+     * container. Default `"48rem"` (768px).
+     *
+     * The default is a reading measure, not an arbitrary cap: at the runtime's
+     * base size it yields roughly 70–90 characters per line, already the top of
+     * the comfortable range. Past about `"60rem"` the eye starts losing its place
+     * on the return sweep, which costs a learner more on a long comprehension
+     * passage than the empty gutters ever did.
+     *
+     * Keep the default when the player owns the whole page (`h-dvh`, no host
+     * chrome) — that is what it was measured for. Set `"none"` when you mount the
+     * player inside your own layout and your container already supplies the
+     * measure, otherwise learners see a column inside a column.
+     */
+    maxWidth?: string;
+}
 type NodeDetail = {
     type: "choiceSet";
     correctChoiceIds: string[];
@@ -189,6 +211,15 @@ interface MountOptions {
      * — useful for white-labelling.
      */
     branding?: TakeBranding;
+    /**
+     * Geometry of the question column, for the cases branding cannot reach.
+     *
+     * The player fills the container you give it, but inside that the questions
+     * sit in a centred 768px reading column. That is right when the player owns
+     * the page and wrong when you mount it inside your own layout, where it reads
+     * as a column inside a column. Pass `{ maxWidth: "none" }` for the latter.
+     */
+    layout?: ShellLayout;
     /**
      * When set, the post-submit "View Full Report" button redirects the browser
      * to this URL with `?submission_id=...&score=...&max_score=...` appended.
@@ -434,4 +465,4 @@ declare const EdpireAssessment: {
     mount(options: MountOptions): EmbedInstance;
 };
 
-export { EdpireAssessment, type EmbedError, type EmbedInstance, type EmbedResult, type ExerciseFeedbackData, type FlatStep, type MountOptions, type OverlayConfig, type QuestionInstance, type RenderQuestionOptions, type ShellLocale, type SpinnerTheme, type StoredAnswer, type SubmitResult, type TakeBranding, buildSubmitPayload, flattenAssessment, renderQuestion };
+export { EdpireAssessment, type EmbedError, type EmbedInstance, type EmbedResult, type ExerciseFeedbackData, type FlatStep, type MountOptions, type OverlayConfig, type QuestionInstance, type RenderQuestionOptions, type ShellLayout, type ShellLocale, type SpinnerTheme, type StoredAnswer, type SubmitResult, type TakeBranding, buildSubmitPayload, flattenAssessment, renderQuestion };