@stackfactor/client-api 1.9.4 → 1.11.0

package/dist/cjs/lib/index.js

@@ -36,8 +36,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.role = exports.riskProfiles = exports.requirementTemplate = exports.requirement = exports.reports = exports.quotas = exports.processes = exports.policyTemplate = exports.policy = exports.microSkillsQuizes = exports.utils = exports.logger = exports.partnerships = exports.learningPath = exports.learningContent = exports.learnerFeedback = exports.labSessions = exports.knowledgeBaseSourceConnectors = exports.knowledgeBaseAgent = exports.knowledgeBase = exports.incident = exports.groups = exports.integrationConfiguration = exports.integration = exports.metricTemplate = exports.metric = exports.dashboard = exports.customFields = exports.controlTemplate = exports.controlResults = exports.control = exports.complianceProfiles = exports.contentGenerator = exports.isSocketError = exports.config = exports.channelProgrammes = exports.address = exports.avatar = exports.aiModelRates = exports.billingProfiles = exports.artifactCatalog = exports.applications = exports.aiAssistant = exports.shouldReturnError = exports.setSessionRefresher = exports.getErrorType = exports.getErrorInformation = exports.errorToString = exports.client = exports.actionNotifications = void 0;
-exports.users = exports.serviceAccounts = exports.userInformation = exports.trainingPlanProficiencyLevel = exports.trainingPlan = exports.tenant = exports.team = exports.onboarding = exports.standardTemplate = exports.standard = exports.skillTemplate = exports.skillAssessmentTestingSession = exports.skillAssessment = exports.skill = exports.session = exports.security = exports.runs = exports.roleTemplate = void 0;
+exports.riskProfiles = exports.requirementTemplate = exports.requirement = exports.reports = exports.quotas = exports.processes = exports.policyTemplate = exports.policy = exports.microSkillsQuizes = exports.utils = exports.logger = exports.partnerships = exports.learningPath = exports.learningContent = exports.knowledgeAssessmentAttempts = exports.learnerFeedback = exports.labSessions = exports.knowledgeBaseSourceConnectors = exports.knowledgeBaseAgent = exports.knowledgeBase = exports.incident = exports.groups = exports.integrationConfiguration = exports.integration = exports.metricTemplate = exports.metric = exports.dashboard = exports.customFields = exports.controlTemplate = exports.controlResults = exports.control = exports.complianceProfiles = exports.contentGenerator = exports.isSocketError = exports.config = exports.channelProgrammes = exports.address = exports.avatar = exports.aiModelRates = exports.billingProfiles = exports.artifactCatalog = exports.applications = exports.aiAssistant = exports.shouldReturnError = exports.setSessionRefresher = exports.getErrorType = exports.getErrorInformation = exports.errorToString = exports.client = exports.actionNotifications = void 0;
+exports.users = exports.userExperiences = exports.serviceAccounts = exports.userInformation = exports.trainingPlanProficiencyLevel = exports.trainingPlan = exports.tenant = exports.team = exports.onboarding = exports.standardTemplate = exports.standard = exports.skillTemplate = exports.skillAssessmentTestingSession = exports.skillAssessment = exports.skill = exports.session = exports.security = exports.runs = exports.roleTemplate = exports.role = void 0;
 exports.actionNotifications = __importStar(require("./actionNotifications.js"));
 var axiosClient_js_1 = require("./axiosClient.js");
 Object.defineProperty(exports, "client", { enumerable: true, get: function () { return axiosClient_js_1.client; } });
@@ -76,6 +76,7 @@ exports.knowledgeBaseAgent = __importStar(require("./knowledgeBaseAgent.js"));
 exports.knowledgeBaseSourceConnectors = __importStar(require("./integrations/knowledgeBaseSourceConnectors.js"));
 exports.labSessions = __importStar(require("./labSessions.js"));
 exports.learnerFeedback = __importStar(require("./learnerFeedback.js"));
+exports.knowledgeAssessmentAttempts = __importStar(require("./knowledgeAssessmentAttempts.js"));
 exports.learningContent = __importStar(require("./learningContent.js"));
 exports.learningPath = __importStar(require("./learningPath.js"));
 exports.partnerships = __importStar(require("./partnerships.js"));
@@ -108,5 +109,6 @@ exports.trainingPlan = __importStar(require("./trainingPlans.js"));
 exports.trainingPlanProficiencyLevel = __importStar(require("./trainingPlansProficiencyLevels.js"));
 exports.userInformation = __importStar(require("./userInformation.js"));
 exports.serviceAccounts = __importStar(require("./serviceAccounts.js"));
+exports.userExperiences = __importStar(require("./userExperiences.js"));
 exports.users = __importStar(require("./users.js"));
 //# sourceMappingURL=index.js.map

package/dist/cjs/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gFAAgE;AAChE,mDAO0B;AANxB,wGAAA,MAAM,OAAA;AACN,+GAAA,aAAa,OAAA;AACb,qHAAA,mBAAmB,OAAA;AACnB,8GAAA,YAAY,OAAA;AACZ,qHAAA,mBAAmB,OAAA;AACnB,mHAAA,iBAAiB,OAAA;AAGnB,gEAAgD;AAChD,kEAAkD;AAClD,wEAAwD;AACxD,wEAAwD;AACxD,kEAAkD;AAClD,sDAAsC;AACtC,wDAAwC;AACxC,4EAA4D;AAC5D,sDAAsC;AACtC,iDAA+B;AAC/B,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AAQtB,uFAAuE;AACvE,8EAA8D;AAC9D,wDAAwC;AACxC,sEAAsD;AACtD,wEAAwD;AACxD,kEAAkD;AAClD,4DAA4C;AAC5C,sDAAsC;AACtC,sEAAsD;AACtD,gEAAgD;AAChD,0FAA0E;AAC1E,sDAAsC;AACtC,0DAA0C;AAC1C,oEAAoD;AACpD,8EAA8D;AAC9D,iHAAiG;AACjG,gEAAgD;AAChD,wEAAwD;AACxD,wEAAwD;AACxD,kEAAkD;AAClD,kEAAkD;AAClD,sDAAsC;AACtC,oDAAoC;AACpC,4EAA4D;AAC5D,sDAAsC;AACtC,sEAAsD;AACtD,4DAA4C;AAC5C,sDAAsC;AACtC,wDAAwC;AACxC,gEAAgD;AAChD,gFAAgE;AAChE,kEAAkD;AAClD,kDAAkC;AAClC,kEAAkD;AAClD,kDAAkC;AAClC,0DAA0C;AAC1C,wDAAwC;AACxC,oDAAoC;AACpC,yEAAyD;AACzD,oGAAoF;AACpF,oEAAoD;AACpD,0DAA0C;AAC1C,0EAA0D;AAC1D,8DAA8C;AAC9C,mDAAmC;AACnC,uDAAuC;AACvC,mEAAmD;AACnD,oGAAoF;AACpF,wEAAwD;AACxD,wEAAwD;AACxD,oDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gFAAgE;AAChE,mDAO0B;AANxB,wGAAA,MAAM,OAAA;AACN,+GAAA,aAAa,OAAA;AACb,qHAAA,mBAAmB,OAAA;AACnB,8GAAA,YAAY,OAAA;AACZ,qHAAA,mBAAmB,OAAA;AACnB,mHAAA,iBAAiB,OAAA;AAGnB,gEAAgD;AAChD,kEAAkD;AAClD,wEAAwD;AACxD,wEAAwD;AACxD,kEAAkD;AAClD,sDAAsC;AACtC,wDAAwC;AACxC,4EAA4D;AAC5D,sDAAsC;AACtC,iDAA+B;AAC/B,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AAatB,uFAAuE;AACvE,8EAA8D;AAC9D,wDAAwC;AACxC,sEAAsD;AACtD,wEAAwD;AACxD,kEAAkD;AAClD,4DAA4C;AAC5C,sDAAsC;AACtC,sEAAsD;AACtD,gEAAgD;AAChD,0FAA0E;AAC1E,sDAAsC;AACtC,0DAA0C;AAC1C,oEAAoD;AACpD,8EAA8D;AAC9D,iHAAiG;AACjG,gEAAgD;AAChD,wEAAwD;AACxD,gGAAgF;AAChF,wEAAwD;AACxD,kEAAkD;AAClD,kEAAkD;AAClD,sDAAsC;AACtC,oDAAoC;AACpC,4EAA4D;AAC5D,sDAAsC;AACtC,sEAAsD;AACtD,4DAA4C;AAC5C,sDAAsC;AACtC,wDAAwC;AACxC,gEAAgD;AAChD,gFAAgE;AAChE,kEAAkD;AAClD,kDAAkC;AAClC,kEAAkD;AAClD,kDAAkC;AAClC,0DAA0C;AAC1C,wDAAwC;AACxC,oDAAoC;AACpC,yEAAyD;AACzD,oGAAoF;AACpF,oEAAoD;AACpD,0DAA0C;AAC1C,0EAA0D;AAC1D,8DAA8C;AAC9C,mDAAmC;AACnC,uDAAuC;AACvC,mEAAmD;AACnD,oGAAoF;AACpF,wEAAwD;AACxD,wEAAwD;AACxD,wEAAwD;AACxD,oDAAoC"}

package/dist/cjs/lib/knowledgeAssessmentAttempts.d.ts

@@ -0,0 +1,75 @@
+/**
+ * One response inside a submitted attempt: the question, and either the
+ * answer ids picked (choice questions) or the text written (free response).
+ */
+export interface KnowledgeAssessmentResponseInput {
+    _id: string;
+    selectedAnswers?: string[];
+    freeText?: string;
+}
+/**
+ * An attempt as the learner submits it. The server scores it and stores the
+ * result; nothing about the score travels up.
+ */
+export interface KnowledgeAssessmentAttemptInput {
+    /** When the learner pressed Start, as an ISO date. */
+    startedAt?: string;
+    responses: KnowledgeAssessmentResponseInput[];
+}
+/**
+ * Get the learner's attempts at a knowledge assessment
+ *
+ * Resolves to the learner's record (`attempts`, `attemptsUsed`) or null when
+ * they have not attempted it yet.
+ *
+ * @param {String} learningContentId The id of the learning content
+ * @param {String} assessmentId The id of the knowledge assessment
+ * @param {String} token Authorization token
+ * @returns {Promise<object>} The response from the server
+ */
+export declare const getAttempts: (learningContentId: string, assessmentId: string, token: string) => Promise<object>;
+/**
+ * Submit one attempt at a knowledge assessment
+ *
+ * The server grades it: choice questions by rule, free responses through
+ * the evaluator agent (left "awaiting evaluation" when none is available).
+ * Resolves to the learner's record with the new attempt last. Rejects with
+ * 403 when the assessment's attempt limit is used up.
+ *
+ * @param {String} learningContentId The id of the learning content
+ * @param {String} assessmentId The id of the knowledge assessment
+ * @param {Object} attempt The attempt: `startedAt` and `responses`
+ * @param {String} token Authorization token
+ * @returns {Promise<object>} The response from the server
+ */
+export declare const submitAttempt: (learningContentId: string, assessmentId: string, attempt: KnowledgeAssessmentAttemptInput, token: string) => Promise<object>;
+/**
+ * Grade again the learner's free responses still awaiting evaluation
+ *
+ * For responses submitted while no evaluator agent was available. Resolves
+ * to `{ record, evaluated, pending }`: the learner's record as `getAttempts`
+ * returns it (null when they have no attempts), how many responses this call
+ * graded, and how many are still pending after it. Safe to repeat.
+ *
+ * @param {String} learningContentId The id of the learning content
+ * @param {String} assessmentId The id of the knowledge assessment
+ * @param {String} token Authorization token
+ * @returns {Promise<object>} The response from the server
+ */
+export declare const evaluatePendingResponses: (learningContentId: string, assessmentId: string, token: string) => Promise<object>;
+/**
+ * Start an attempt at a knowledge assessment
+ *
+ * The server records the start time and returns it, so the time limit is
+ * measured from its clock. Resolves to `{ startedAt, resumed, attemptsUsed }`;
+ * `resumed` is true when a start still within the time limit was already
+ * recorded, which is how a reloaded page carries on. Rejects with 403 when
+ * the attempt limit is used up.
+ *
+ * @param {String} learningContentId The id of the learning content
+ * @param {String} assessmentId The id of the knowledge assessment
+ * @param {String} token Authorization token
+ * @returns {Promise<object>} The response from the server
+ */
+export declare const startAttempt: (learningContentId: string, assessmentId: string, token: string) => Promise<object>;
+//# sourceMappingURL=knowledgeAssessmentAttempts.d.ts.map

package/dist/cjs/lib/knowledgeAssessmentAttempts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledgeAssessmentAttempts.d.ts","sourceRoot":"","sources":["../../../src/lib/knowledgeAssessmentAttempts.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,WAAW,gCAAgC;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,gCAAgC,EAAE,CAAC;CAC/C;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GACtB,mBAAmB,MAAM,EACzB,cAAc,MAAM,EACpB,OAAO,MAAM,KACZ,OAAO,CAAC,MAAM,CAgBhB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,GACxB,mBAAmB,MAAM,EACzB,cAAc,MAAM,EACpB,SAAS,+BAA+B,EACxC,OAAO,MAAM,KACZ,OAAO,CAAC,MAAM,CAiBhB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,GACnC,mBAAmB,MAAM,EACzB,cAAc,MAAM,EACpB,OAAO,MAAM,KACZ,OAAO,CAAC,MAAM,CAiBhB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,GACvB,mBAAmB,MAAM,EACzB,cAAc,MAAM,EACpB,OAAO,MAAM,KACZ,OAAO,CAAC,MAAM,CAiBhB,CAAC"}

package/dist/cjs/lib/knowledgeAssessmentAttempts.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startAttempt = exports.evaluatePendingResponses = exports.submitAttempt = exports.getAttempts = void 0;
+const axiosClient_js_1 = require("./axiosClient.js");
+/**
+ * Get the learner's attempts at a knowledge assessment
+ *
+ * Resolves to the learner's record (`attempts`, `attemptsUsed`) or null when
+ * they have not attempted it yet.
+ *
+ * @param {String} learningContentId The id of the learning content
+ * @param {String} assessmentId The id of the knowledge assessment
+ * @param {String} token Authorization token
+ * @returns {Promise<object>} The response from the server
+ */
+const getAttempts = (learningContentId, assessmentId, token) => {
+    return new Promise((resolve, reject) => {
+        const confirmationRequest = axiosClient_js_1.client.get(`/api/v1/exceed/knowledgeassessmentattempts/${learningContentId}/${assessmentId}`, {
+            headers: { authorization: token },
+        });
+        confirmationRequest
+            .then((response) => {
+            resolve(response.data);
+        })
+            .catch((error) => {
+            reject(error);
+        });
+    });
+};
+exports.getAttempts = getAttempts;
+/**
+ * Submit one attempt at a knowledge assessment
+ *
+ * The server grades it: choice questions by rule, free responses through
+ * the evaluator agent (left "awaiting evaluation" when none is available).
+ * Resolves to the learner's record with the new attempt last. Rejects with
+ * 403 when the assessment's attempt limit is used up.
+ *
+ * @param {String} learningContentId The id of the learning content
+ * @param {String} assessmentId The id of the knowledge assessment
+ * @param {Object} attempt The attempt: `startedAt` and `responses`
+ * @param {String} token Authorization token
+ * @returns {Promise<object>} The response from the server
+ */
+const submitAttempt = (learningContentId, assessmentId, attempt, token) => {
+    return new Promise((resolve, reject) => {
+        const confirmationRequest = axiosClient_js_1.client.post(`/api/v1/exceed/knowledgeassessmentattempts/${learningContentId}/${assessmentId}`, attempt, {
+            headers: { authorization: token },
+        });
+        confirmationRequest
+            .then((response) => {
+            resolve(response.data);
+        })
+            .catch((error) => {
+            reject(error);
+        });
+    });
+};
+exports.submitAttempt = submitAttempt;
+/**
+ * Grade again the learner's free responses still awaiting evaluation
+ *
+ * For responses submitted while no evaluator agent was available. Resolves
+ * to `{ record, evaluated, pending }`: the learner's record as `getAttempts`
+ * returns it (null when they have no attempts), how many responses this call
+ * graded, and how many are still pending after it. Safe to repeat.
+ *
+ * @param {String} learningContentId The id of the learning content
+ * @param {String} assessmentId The id of the knowledge assessment
+ * @param {String} token Authorization token
+ * @returns {Promise<object>} The response from the server
+ */
+const evaluatePendingResponses = (learningContentId, assessmentId, token) => {
+    return new Promise((resolve, reject) => {
+        const confirmationRequest = axiosClient_js_1.client.post(`/api/v1/exceed/knowledgeassessmentattempts/${learningContentId}/${assessmentId}/evaluate`, {}, {
+            headers: { authorization: token },
+        });
+        confirmationRequest
+            .then((response) => {
+            resolve(response.data);
+        })
+            .catch((error) => {
+            reject(error);
+        });
+    });
+};
+exports.evaluatePendingResponses = evaluatePendingResponses;
+/**
+ * Start an attempt at a knowledge assessment
+ *
+ * The server records the start time and returns it, so the time limit is
+ * measured from its clock. Resolves to `{ startedAt, resumed, attemptsUsed }`;
+ * `resumed` is true when a start still within the time limit was already
+ * recorded, which is how a reloaded page carries on. Rejects with 403 when
+ * the attempt limit is used up.
+ *
+ * @param {String} learningContentId The id of the learning content
+ * @param {String} assessmentId The id of the knowledge assessment
+ * @param {String} token Authorization token
+ * @returns {Promise<object>} The response from the server
+ */
+const startAttempt = (learningContentId, assessmentId, token) => {
+    return new Promise((resolve, reject) => {
+        const confirmationRequest = axiosClient_js_1.client.post(`/api/v1/exceed/knowledgeassessmentattempts/${learningContentId}/${assessmentId}/start`, {}, {
+            headers: { authorization: token },
+        });
+        confirmationRequest
+            .then((response) => {
+            resolve(response.data);
+        })
+            .catch((error) => {
+            reject(error);
+        });
+    });
+};
+exports.startAttempt = startAttempt;
+//# sourceMappingURL=knowledgeAssessmentAttempts.js.map

package/dist/cjs/lib/knowledgeAssessmentAttempts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledgeAssessmentAttempts.js","sourceRoot":"","sources":["../../../src/lib/knowledgeAssessmentAttempts.ts"],"names":[],"mappings":"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"}

package/dist/cjs/lib/knowledgeBaseAgent.d.ts

@@ -4,12 +4,39 @@ export interface SearchOptions {
     contentTypeFilter?: string[];
     /** How many chunks at most, 1–50. */
     topK?: number;
+    /**
+     * Keep to these documents: the ones a skill's STACKFACTOR references cite.
+     * At most 500 per search; more are split over several.
+     */
+    documentIds?: string[];
 }
-/** A retrieved chunk: its text and where it came from, embeddings stripped. */
+/** A skill a retrieved passage teaches, as labelling named it. */
+export interface RetrievedChunkSkill {
+    name: string | null;
+    scope: string | null;
+    proficiencyLevel: string | null;
+    /** The passage's microskills under this skill, by name. */
+    microSkills: string[];
+}
+/**
+ * A retrieved chunk: the passage, where it came from — what a STACKFACTOR
+ * reference cites — and what it teaches. No embedding, no redaction map.
+ */
 export interface RetrievedChunk {
     _id: string;
+    knowledgeBaseId: string;
     documentId: string;
+    /** The document's name: what a STACKFACTOR reference is titled by. */
+    documentName: string | null;
+    chunkIndex: number | null;
+    sectionTitle: string | null;
+    pageNumber: number | null;
+    contentType: string | null;
     text: string;
+    imageDescription: string | null;
+    skills: RetrievedChunkSkill[];
+    /** How well it matched, best first. */
+    score: number | null;
     [field: string]: unknown;
 }
 /** What a sync run is handed when it starts: its knowledge base and source, without credentials. */
@@ -80,7 +107,7 @@ export interface IngestOutcome {
  * POST /api/v1/knowledge-base/:id/search
  * @param {String} knowledgeBaseId The knowledge base
  * @param {String} query The task, as text (1–4000 characters)
- * @param {SearchOptions} options `contentTypeFilter`, `topK`
+ * @param {SearchOptions} options `contentTypeFilter`, `topK`, `documentIds`
  * @param {String} token The run's AGENT token
  * @returns {Promise<{chunks: RetrievedChunk[]}>}
  */

package/dist/cjs/lib/knowledgeBaseAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledgeBaseAgent.d.ts","sourceRoot":"","sources":["../../../src/lib/knowledgeBaseAgent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"knowledgeBaseAgent.d.ts","sourceRoot":"","sources":["../../../src/lib/knowledgeBaseAgent.ts"],"names":[],"mappings":"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"}

package/dist/cjs/lib/knowledgeBaseAgent.js

@@ -35,7 +35,7 @@ const compact = (object) => Object.fromEntries(Object.entries(object).filter(([,
  * POST /api/v1/knowledge-base/:id/search
  * @param {String} knowledgeBaseId The knowledge base
  * @param {String} query The task, as text (1–4000 characters)
- * @param {SearchOptions} options `contentTypeFilter`, `topK`
+ * @param {SearchOptions} options `contentTypeFilter`, `topK`, `documentIds`
  * @param {String} token The run's AGENT token
  * @returns {Promise<{chunks: RetrievedChunk[]}>}
  */

package/dist/cjs/lib/knowledgeBaseAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"knowledgeBaseAgent.js","sourceRoot":"","sources":["../../../src/lib/knowledgeBaseAgent.ts"],"names":[],"mappings":"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avB"}
+{"version":3,"file":"knowledgeBaseAgent.js","sourceRoot":"","sources":["../../../src/lib/knowledgeBaseAgent.ts"],"names":[],"mappings":"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avB"}

package/dist/cjs/lib/learningContent.d.ts

@@ -367,4 +367,109 @@ export declare const storeLearningContentMicroSkillLearningContentActivitySceneA
 export declare const setLearningContentSettingsFlags: (id: string, settings: object, token: string) => Promise<{
     updated: boolean;
 }>;
+/**
+ * One question on a knowledge assessment.
+ *
+ * The draft is permissive: a question can be saved half-written, with no
+ * answers yet, and the editor fills it in over time. `_id` is assigned by the
+ * server on first save and comes back on the learning content.
+ */
+export interface KnowledgeAssessmentQuestionInput {
+    _id?: string;
+    /** The question as shown to the learner. */
+    value?: string;
+    /** A `KNOWLEDGE_ASSESSMENT_QUESTION_TYPES` value. */
+    type?: number;
+    answers?: {
+        _id?: string;
+        value?: string;
+        correct?: boolean;
+    }[];
+    /** Shown to the learner after answering, whatever the outcome. */
+    explanation?: string;
+    /** Free response only: what a full-marks answer contains. */
+    modelAnswer?: string;
+    /** Free response only: how to award partial credit; never shown to the learner. */
+    rubric?: string;
+    /** Weight of the question in the final score; 1 by default. */
+    points?: number;
+}
+/**
+ * The rules that decide whether a learner has passed a knowledge assessment.
+ *
+ * `KNOWLEDGE_ASSESSMENT_UNLIMITED` (0) in `maxAttempts` or `timeLimitMinutes`
+ * means no cap: a quiz is usually open-ended, an exam usually is not.
+ */
+export interface KnowledgeAssessmentCompletionRules {
+    /** Minimum score to pass, 0-100, as a percentage of available points. */
+    passingScore?: number;
+    /** Attempts allowed; 0 means unlimited. */
+    maxAttempts?: number;
+    /** Time allowed for one attempt; 0 means no limit. */
+    timeLimitMinutes?: number;
+    /** Present the questions in a different order on every attempt. */
+    shuffleQuestions?: boolean;
+}
+/**
+ * One knowledge assessment (a quiz or an exam) on a piece of learning content.
+ *
+ * This is the TEMPLATE: what the assessment asks and what passing it takes,
+ * never a learner's attempt at it.
+ *
+ * Authored draft-then-published like the content that owns it, exactly as a
+ * live session is. These fields are the draft's fields, sent flat — the
+ * server puts them on the draft and leaves the published copy alone until the
+ * content itself is published.
+ *
+ * `_id` is required even when creating: the bulk sync matches by id, so the
+ * caller mints one (a 24-character hex ObjectId) for a new assessment rather
+ * than the server assigning it.
+ */
+export interface KnowledgeAssessmentInput {
+    _id: string;
+    /** Which proficiency level of the content this assessment belongs to. */
+    proficiencyLevel?: string;
+    title?: string;
+    description?: string | null;
+    /** A `KNOWLEDGE_ASSESSMENT_TYPES` value — Quiz or Exam. */
+    type?: number;
+    /** Display order within the proficiency level. */
+    index?: number;
+    /** Microskill ids the assessment covers. */
+    microSkills?: string[];
+    estimatedDurationMinutes?: number;
+    /** What the learner reads before starting. */
+    instructions?: string | null;
+    questions?: KnowledgeAssessmentQuestionInput[];
+    completionRules?: KnowledgeAssessmentCompletionRules;
+}
+/**
+ * Update a single knowledge assessment for a specific learning content
+ *
+ * Merges `data` into the assessment's DRAFT and bumps its version. Reads come
+ * back on the learning content itself under `knowledgeAssessments`, and
+ * delete, discard and publish ride the content's own lifecycle — so this and
+ * the bulk sync below are the whole write surface.
+ *
+ * @param {String} id The id of the learning content
+ * @param {String} knowledgeAssessmentId The id of the knowledge assessment
+ * @param {Object} data The knowledge assessment data
+ * @param {String} token Authorization token
+ * @returns {Promise<object>} The response from the server
+ */
+export declare const updateLearningContentKnowledgeAssessment: (id: string, knowledgeAssessmentId: string, data: KnowledgeAssessmentInput | object, token: string) => Promise<object>;
+/**
+ * Update knowledge assessments for a specific learning content
+ *
+ * `data` is the DESIRED FINAL SET, not a list of changes: the server diffs it
+ * against what exists and creates, updates and deletes to match. An
+ * assessment left out of the array is deleted, so send the whole set every
+ * time.
+ *
+ * @param {String} id The id of the learning content
+ * @param {Array<Object>} data The knowledge assessments data
+ * @param {String} token Authorization token
+ * @returns {Promise<object>} The response from the server
+ */
+export declare const updateLearningContentKnowledgeAssessments: (id: string, data: KnowledgeAssessmentInput[] | object[], token: string) => Promise<object>;
 //# sourceMappingURL=learningContent.d.ts.map

package/dist/cjs/lib/learningContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"learningContent.d.ts","sourceRoot":"","sources":["../../../src/lib/learningContent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"learningContent.d.ts","sourceRoot":"","sources":["../../../src/lib/learningContent.ts"],"names":[],"mappings":"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"}

package/dist/cjs/lib/learningContent.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setLearningContentSettingsFlags = exports.storeLearningContentMicroSkillLearningContentActivitySceneAudio = exports.storeLearningContentMicroSkillLearningContentActivityMedia = exports.deleteLearningContentMicroSkills = exports.saveLearningContentMicroSkill = exports.watchLearningContent = exports.updateLearningContentLiveSessions = exports.updateLearningContentLiveSession = exports.updateLearningContentLabConfigurations = exports.updateLearningContentLabConfiguration = exports.uploadLearningContentLabConfigurationMedia = exports.getLearningContentLabConfigurationMedia = exports.generateLabConfigurationContent = exports.uploadLearningContentMicroSkillLearningContentActivityMedia = exports.setLearningContentTags = exports.setLearningContentLearningMicroSkillContentInformation = exports.setLearningContentLearningContentInformation = exports.setLearningContentPartialContentInformation = exports.setLearningContentSettings = exports.setLearningContentInformation = exports.publishLearningContent = exports.migrateLearningContentStorageType = exports.getLearningContentMicroSkillLearningContentActivityMedia = exports.getLearningContentMicroSkillLearningContentActivitySceneAudio = exports.getLearningContentList = exports.getLearningContentInformationById = exports.generateLearningActivityContent = exports.discardLearningContentChanges = exports.deleteLearningContentMicroSkillLearningContentActivityMedia = exports.deleteLearningContent = exports.createLearningContent = exports.utils = void 0;
+exports.updateLearningContentKnowledgeAssessments = exports.updateLearningContentKnowledgeAssessment = exports.setLearningContentSettingsFlags = exports.storeLearningContentMicroSkillLearningContentActivitySceneAudio = exports.storeLearningContentMicroSkillLearningContentActivityMedia = exports.deleteLearningContentMicroSkills = exports.saveLearningContentMicroSkill = exports.watchLearningContent = exports.updateLearningContentLiveSessions = exports.updateLearningContentLiveSession = exports.updateLearningContentLabConfigurations = exports.updateLearningContentLabConfiguration = exports.uploadLearningContentLabConfigurationMedia = exports.getLearningContentLabConfigurationMedia = exports.generateLabConfigurationContent = exports.uploadLearningContentMicroSkillLearningContentActivityMedia = exports.setLearningContentTags = exports.setLearningContentLearningMicroSkillContentInformation = exports.setLearningContentLearningContentInformation = exports.setLearningContentPartialContentInformation = exports.setLearningContentSettings = exports.setLearningContentInformation = exports.publishLearningContent = exports.migrateLearningContentStorageType = exports.getLearningContentMicroSkillLearningContentActivityMedia = exports.getLearningContentMicroSkillLearningContentActivitySceneAudio = exports.getLearningContentList = exports.getLearningContentInformationById = exports.generateLearningActivityContent = exports.discardLearningContentChanges = exports.deleteLearningContentMicroSkillLearningContentActivityMedia = exports.deleteLearningContent = exports.createLearningContent = exports.utils = void 0;
 const utils_js_1 = require("./utils.js");
 const axiosClient_js_1 = require("./axiosClient.js");
 const socket_io_client_1 = require("socket.io-client");
@@ -971,4 +971,69 @@ const setLearningContentSettingsFlags = (id, settings, token) => {
     });
 };
 exports.setLearningContentSettingsFlags = setLearningContentSettingsFlags;
+/**
+ * Update a single knowledge assessment for a specific learning content
+ *
+ * Merges `data` into the assessment's DRAFT and bumps its version. Reads come
+ * back on the learning content itself under `knowledgeAssessments`, and
+ * delete, discard and publish ride the content's own lifecycle — so this and
+ * the bulk sync below are the whole write surface.
+ *
+ * @param {String} id The id of the learning content
+ * @param {String} knowledgeAssessmentId The id of the knowledge assessment
+ * @param {Object} data The knowledge assessment data
+ * @param {String} token Authorization token
+ * @returns {Promise<object>} The response from the server
+ */
+const updateLearningContentKnowledgeAssessment = (id, knowledgeAssessmentId, data, token) => {
+    return new Promise((resolve, reject) => {
+        const requestData = {
+            id: id,
+            knowledgeAssessmentId: knowledgeAssessmentId,
+            data: data,
+        };
+        const confirmationRequest = axiosClient_js_1.client.post(`/api/v1/exceed/learningcontent/updateknowledgeassessment`, requestData, {
+            headers: { authorization: token },
+        });
+        confirmationRequest
+            .then((response) => {
+            resolve(response.data);
+        })
+            .catch((error) => {
+            reject(error);
+        });
+    });
+};
+exports.updateLearningContentKnowledgeAssessment = updateLearningContentKnowledgeAssessment;
+/**
+ * Update knowledge assessments for a specific learning content
+ *
+ * `data` is the DESIRED FINAL SET, not a list of changes: the server diffs it
+ * against what exists and creates, updates and deletes to match. An
+ * assessment left out of the array is deleted, so send the whole set every
+ * time.
+ *
+ * @param {String} id The id of the learning content
+ * @param {Array<Object>} data The knowledge assessments data
+ * @param {String} token Authorization token
+ * @returns {Promise<object>} The response from the server
+ */
+const updateLearningContentKnowledgeAssessments = (id, data, token) => {
+    return new Promise((resolve, reject) => {
+        const requestData = {
+            data: data,
+        };
+        const confirmationRequest = axiosClient_js_1.client.post(`/api/v1/exceed/learningcontent/updateknowledgeassessments/${id}`, requestData, {
+            headers: { authorization: token },
+        });
+        confirmationRequest
+            .then((response) => {
+            resolve(response.data);
+        })
+            .catch((error) => {
+            reject(error);
+        });
+    });
+};
+exports.updateLearningContentKnowledgeAssessments = updateLearningContentKnowledgeAssessments;
 //# sourceMappingURL=learningContent.js.map