@instructure/athena-api-client 3.39.3 → 3.40.0

package/dist/esm/apis/AdminApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { AdminChat, AdminChatAnalysis, AdminChatCanvasUsage, AdminChatWithStats, AdminCohortStats, AdminPaginatedActiveStreaks, AdminPaginatedChats, AdminPaginatedLastExchanges, AdminPaginatedQuizSessions, AdminPaginatedStudyObjectiveUserCounts, AdminPaginatedStudyObjectives, AdminPaginatedTaxonomyEnrollments, AdminResetLearningDataResponse, AdminStreak, AdminStudyObjectiveSummary, AdminTriggerAnalysisResponse, AdminUpdateChatRequest, AdminUserActivity, AdminUserActivityTotals, AdminUserEngagement, AdminUsersActivityRequest, AdminUsersActivityTotalsRequest, QuizSessionSummary } from '../models/index';
+import type { AdminChat, AdminChatAnalysis, AdminChatCanvasUsage, AdminChatWithStats, AdminCohortStats, AdminPaginatedActiveStreaks, AdminPaginatedChats, AdminPaginatedLastExchanges, AdminPaginatedQuizParticipantSessions, AdminPaginatedQuizSessions, AdminPaginatedStudyObjectiveUserCounts, AdminPaginatedStudyObjectives, AdminPaginatedTaxonomyEnrollments, AdminResetLearningDataResponse, AdminStreak, AdminStudyObjectiveSummary, AdminTriggerAnalysisResponse, AdminUpdateChatRequest, AdminUserActivity, AdminUserActivityTotals, AdminUserEngagement, AdminUsersActivityRequest, AdminUsersActivityTotalsRequest, QuizSessionSummary } from '../models/index';
 export interface AdminGetChatRequest {
     xUserId: string;
     chatId: string;
@@ -72,6 +72,12 @@ export interface AdminListLastExchangesRequest {
     maxUserMessages?: number;
     inactiveDays?: number;
 }
+export interface AdminListQuizParticipantSessionsRequest {
+    xUserId: string;
+    quizId: string;
+    limit?: number;
+    cursor?: string;
+}
 export interface AdminListQuizSessionsRequest {
     xUserId: string;
     limit?: number;
@@ -239,6 +245,16 @@ export declare class AdminApi extends runtime.BaseAPI {
      * List the final user message and assistant reply for low-engagement new users
      */
     adminListLastExchanges(requestParameters: AdminListLastExchangesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminPaginatedLastExchanges>;
+    /**
+     * Admin-only. Returns a paginated list of all sessions on one quiz, newest first, across the quiz owner and every learner who opened it by share link. Each item identifies the learner by external id and says whether that learner is the quiz owner. Intended for admin-style views in calling applications; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation, so the quiz must belong to a user within the caller\'s account. Like the other admin quiz endpoints, this is not gated on the `enhanced-quizzing` feature flag.
+     * List every learner\'s sessions on a quiz within the account
+     */
+    adminListQuizParticipantSessionsRaw(requestParameters: AdminListQuizParticipantSessionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdminPaginatedQuizParticipantSessions>>;
+    /**
+     * Admin-only. Returns a paginated list of all sessions on one quiz, newest first, across the quiz owner and every learner who opened it by share link. Each item identifies the learner by external id and says whether that learner is the quiz owner. Intended for admin-style views in calling applications; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation, so the quiz must belong to a user within the caller\'s account. Like the other admin quiz endpoints, this is not gated on the `enhanced-quizzing` feature flag.
+     * List every learner\'s sessions on a quiz within the account
+     */
+    adminListQuizParticipantSessions(requestParameters: AdminListQuizParticipantSessionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminPaginatedQuizParticipantSessions>;
     /**
      * Returns a paginated list of quiz sessions belonging to users within the caller\'s account, ordered by start date (newest first), with embedded quiz info, the owning user\'s external id, and a score summary (including the number of questions answered). Intended for admin-style views in calling applications; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation. Questions and responses are not included; fetch them per session via the summary endpoint. Like the summary endpoint, this is not gated on the `enhanced-quizzing` feature flag.
      * List recent quiz sessions across all account users

package/dist/esm/apis/AdminApi.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
-import { AdminChatFromJSON, AdminChatAnalysisFromJSON, AdminChatCanvasUsageFromJSON, AdminChatWithStatsFromJSON, AdminCohortStatsFromJSON, AdminPaginatedActiveStreaksFromJSON, AdminPaginatedChatsFromJSON, AdminPaginatedLastExchangesFromJSON, AdminPaginatedQuizSessionsFromJSON, AdminPaginatedStudyObjectiveUserCountsFromJSON, AdminPaginatedStudyObjectivesFromJSON, AdminPaginatedTaxonomyEnrollmentsFromJSON, AdminResetLearningDataResponseFromJSON, AdminStreakFromJSON, AdminStudyObjectiveSummaryFromJSON, AdminTriggerAnalysisResponseFromJSON, AdminUpdateChatRequestToJSON, AdminUserActivityFromJSON, AdminUserActivityTotalsFromJSON, AdminUserEngagementFromJSON, AdminUsersActivityRequestToJSON, AdminUsersActivityTotalsRequestToJSON, QuizSessionSummaryFromJSON, } from '../models/index';
+import { AdminChatFromJSON, AdminChatAnalysisFromJSON, AdminChatCanvasUsageFromJSON, AdminChatWithStatsFromJSON, AdminCohortStatsFromJSON, AdminPaginatedActiveStreaksFromJSON, AdminPaginatedChatsFromJSON, AdminPaginatedLastExchangesFromJSON, AdminPaginatedQuizParticipantSessionsFromJSON, AdminPaginatedQuizSessionsFromJSON, AdminPaginatedStudyObjectiveUserCountsFromJSON, AdminPaginatedStudyObjectivesFromJSON, AdminPaginatedTaxonomyEnrollmentsFromJSON, AdminResetLearningDataResponseFromJSON, AdminStreakFromJSON, AdminStudyObjectiveSummaryFromJSON, AdminTriggerAnalysisResponseFromJSON, AdminUpdateChatRequestToJSON, AdminUserActivityFromJSON, AdminUserActivityTotalsFromJSON, AdminUserEngagementFromJSON, AdminUsersActivityRequestToJSON, AdminUsersActivityTotalsRequestToJSON, QuizSessionSummaryFromJSON, } from '../models/index';
 /**
  *
  */
@@ -576,6 +576,53 @@ export class AdminApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Admin-only. Returns a paginated list of all sessions on one quiz, newest first, across the quiz owner and every learner who opened it by share link. Each item identifies the learner by external id and says whether that learner is the quiz owner. Intended for admin-style views in calling applications; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation, so the quiz must belong to a user within the caller\'s account. Like the other admin quiz endpoints, this is not gated on the `enhanced-quizzing` feature flag.
+     * List every learner\'s sessions on a quiz within the account
+     */
+    adminListQuizParticipantSessionsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['xUserId'] == null) {
+                throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling adminListQuizParticipantSessions().');
+            }
+            if (requestParameters['quizId'] == null) {
+                throw new runtime.RequiredError('quizId', 'Required parameter "quizId" was null or undefined when calling adminListQuizParticipantSessions().');
+            }
+            const queryParameters = {};
+            if (requestParameters['limit'] != null) {
+                queryParameters['limit'] = requestParameters['limit'];
+            }
+            if (requestParameters['cursor'] != null) {
+                queryParameters['cursor'] = requestParameters['cursor'];
+            }
+            const headerParameters = {};
+            if (requestParameters['xUserId'] != null) {
+                headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
+            }
+            let urlPath = `/api/v1/admin/quizzes/{quizId}/sessions`;
+            urlPath = urlPath.replace(`{${"quizId"}}`, encodeURIComponent(String(requestParameters['quizId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AdminPaginatedQuizParticipantSessionsFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Admin-only. Returns a paginated list of all sessions on one quiz, newest first, across the quiz owner and every learner who opened it by share link. Each item identifies the learner by external id and says whether that learner is the quiz owner. Intended for admin-style views in calling applications; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation, so the quiz must belong to a user within the caller\'s account. Like the other admin quiz endpoints, this is not gated on the `enhanced-quizzing` feature flag.
+     * List every learner\'s sessions on a quiz within the account
+     */
+    adminListQuizParticipantSessions(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.adminListQuizParticipantSessionsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Returns a paginated list of quiz sessions belonging to users within the caller\'s account, ordered by start date (newest first), with embedded quiz info, the owning user\'s external id, and a score summary (including the number of questions answered). Intended for admin-style views in calling applications; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation. Questions and responses are not included; fetch them per session via the summary endpoint. Like the summary endpoint, this is not gated on the `enhanced-quizzing` feature flag.
      * List recent quiz sessions across all account users

package/dist/esm/apis/QuizzesApi.d.ts

@@ -10,17 +10,26 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { PaginatedQuizzes, QuizWithQuestions } from '../models/index';
+import type { PaginatedQuizzes, QuizSharing, QuizWithQuestions, UpdateQuizSharingRequest } from '../models/index';
 export interface GetQuizRequest {
     quizId: string;
     xUserId: string;
 }
+export interface GetQuizSharingRequest {
+    quizId: string;
+    xUserId: string;
+}
 export interface ListQuizzesRequest {
     xUserId: string;
     limit?: number;
     cursor?: string;
     mode?: ListQuizzesModeEnum;
 }
+export interface UpdateQuizSharingOperationRequest {
+    quizId: string;
+    xUserId: string;
+    updateQuizSharingRequest: UpdateQuizSharingRequest;
+}
 /**
  *
  */
@@ -35,6 +44,16 @@ export declare class QuizzesApi extends runtime.BaseAPI {
      * Get quiz with questions
      */
     getQuiz(requestParameters: GetQuizRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<QuizWithQuestions>;
+    /**
+     * Returns whether the quiz is open to other learners by link, and the link token if so. Only the quiz owner can read this.
+     * Get a quiz\'s sharing state
+     */
+    getQuizSharingRaw(requestParameters: GetQuizSharingRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<QuizSharing>>;
+    /**
+     * Returns whether the quiz is open to other learners by link, and the link token if so. Only the quiz owner can read this.
+     * Get a quiz\'s sharing state
+     */
+    getQuizSharing(requestParameters: GetQuizSharingRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<QuizSharing>;
     /**
      * Returns a paginated list of quizzes owned by the authenticated user, ordered by creation date (newest first).
      * List user quizzes
@@ -45,6 +64,16 @@ export declare class QuizzesApi extends runtime.BaseAPI {
      * List user quizzes
      */
     listQuizzes(requestParameters: ListQuizzesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedQuizzes>;
+    /**
+     * Enabling issues a link token other learners can redeem to take the quiz under their own sessions; enabling an already-shared quiz keeps its token. Disabling revokes the token so the link stops resolving. Sessions learners already started stay theirs. Only the quiz owner can change this.
+     * Turn link sharing on or off for a quiz
+     */
+    updateQuizSharingRaw(requestParameters: UpdateQuizSharingOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<QuizSharing>>;
+    /**
+     * Enabling issues a link token other learners can redeem to take the quiz under their own sessions; enabling an already-shared quiz keeps its token. Disabling revokes the token so the link stops resolving. Sessions learners already started stay theirs. Only the quiz owner can change this.
+     * Turn link sharing on or off for a quiz
+     */
+    updateQuizSharing(requestParameters: UpdateQuizSharingOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<QuizSharing>;
 }
 /**
  * @export

package/dist/esm/apis/QuizzesApi.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
-import { PaginatedQuizzesFromJSON, QuizWithQuestionsFromJSON, } from '../models/index';
+import { PaginatedQuizzesFromJSON, QuizSharingFromJSON, QuizWithQuestionsFromJSON, UpdateQuizSharingRequestToJSON, } from '../models/index';
 /**
  *
  */
@@ -67,6 +67,47 @@ export class QuizzesApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Returns whether the quiz is open to other learners by link, and the link token if so. Only the quiz owner can read this.
+     * Get a quiz\'s sharing state
+     */
+    getQuizSharingRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['quizId'] == null) {
+                throw new runtime.RequiredError('quizId', 'Required parameter "quizId" was null or undefined when calling getQuizSharing().');
+            }
+            if (requestParameters['xUserId'] == null) {
+                throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling getQuizSharing().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (requestParameters['xUserId'] != null) {
+                headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
+            }
+            let urlPath = `/api/v1/quizzes/{quizId}/sharing`;
+            urlPath = urlPath.replace(`{${"quizId"}}`, encodeURIComponent(String(requestParameters['quizId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => QuizSharingFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Returns whether the quiz is open to other learners by link, and the link token if so. Only the quiz owner can read this.
+     * Get a quiz\'s sharing state
+     */
+    getQuizSharing(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getQuizSharingRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Returns a paginated list of quizzes owned by the authenticated user, ordered by creation date (newest first).
      * List user quizzes
@@ -113,6 +154,52 @@ export class QuizzesApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Enabling issues a link token other learners can redeem to take the quiz under their own sessions; enabling an already-shared quiz keeps its token. Disabling revokes the token so the link stops resolving. Sessions learners already started stay theirs. Only the quiz owner can change this.
+     * Turn link sharing on or off for a quiz
+     */
+    updateQuizSharingRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['quizId'] == null) {
+                throw new runtime.RequiredError('quizId', 'Required parameter "quizId" was null or undefined when calling updateQuizSharing().');
+            }
+            if (requestParameters['xUserId'] == null) {
+                throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling updateQuizSharing().');
+            }
+            if (requestParameters['updateQuizSharingRequest'] == null) {
+                throw new runtime.RequiredError('updateQuizSharingRequest', 'Required parameter "updateQuizSharingRequest" was null or undefined when calling updateQuizSharing().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['xUserId'] != null) {
+                headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
+            }
+            let urlPath = `/api/v1/quizzes/{quizId}/sharing`;
+            urlPath = urlPath.replace(`{${"quizId"}}`, encodeURIComponent(String(requestParameters['quizId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'PATCH',
+                headers: headerParameters,
+                query: queryParameters,
+                body: UpdateQuizSharingRequestToJSON(requestParameters['updateQuizSharingRequest']),
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => QuizSharingFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Enabling issues a link token other learners can redeem to take the quiz under their own sessions; enabling an already-shared quiz keeps its token. Disabling revokes the token so the link stops resolving. Sessions learners already started stay theirs. Only the quiz owner can change this.
+     * Turn link sharing on or off for a quiz
+     */
+    updateQuizSharing(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.updateQuizSharingRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
 }
 /**
  * @export

package/dist/esm/apis/ResourcesApi.d.ts

@@ -16,6 +16,7 @@ export interface ListResourcesRequest {
     limit?: number;
     cursor?: string;
     type?: ListResourcesTypeEnum;
+    ownership?: ListResourcesOwnershipEnum;
     courseId?: string;
     chatId?: string;
     studySpaceId?: string;
@@ -26,12 +27,12 @@ export interface ListResourcesRequest {
  */
 export declare class ResourcesApi extends runtime.BaseAPI {
     /**
-     * Returns the authenticated user\'s quizzes and flashcard sets, newest first, each with its question rollup, originating chat, course attribution, study objective, and session activity. Intended for a library view, so every row carries enough to render a card without a follow-up request.
+     * Returns the authenticated user\'s quizzes and flashcard sets, newest first, each with its question rollup, originating chat, course attribution, study objective, and session activity. Intended for a library view, so every row carries enough to render a card without a follow-up request. By default lists what the user generated; `ownership=shared` lists other learners\' resources the user has opened through a share link, with the owner\'s chat, objective, space, and course withheld.
      * List the user\'s generated study resources
      */
     listResourcesRaw(requestParameters: ListResourcesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResources>>;
     /**
-     * Returns the authenticated user\'s quizzes and flashcard sets, newest first, each with its question rollup, originating chat, course attribution, study objective, and session activity. Intended for a library view, so every row carries enough to render a card without a follow-up request.
+     * Returns the authenticated user\'s quizzes and flashcard sets, newest first, each with its question rollup, originating chat, course attribution, study objective, and session activity. Intended for a library view, so every row carries enough to render a card without a follow-up request. By default lists what the user generated; `ownership=shared` lists other learners\' resources the user has opened through a share link, with the owner\'s chat, objective, space, and course withheld.
      * List the user\'s generated study resources
      */
     listResources(requestParameters: ListResourcesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResources>;
@@ -44,6 +45,14 @@ export declare const ListResourcesTypeEnum: {
     readonly Flashcards: "flashcards";
 };
 export type ListResourcesTypeEnum = typeof ListResourcesTypeEnum[keyof typeof ListResourcesTypeEnum];
+/**
+ * @export
+ */
+export declare const ListResourcesOwnershipEnum: {
+    readonly Owned: "owned";
+    readonly Shared: "shared";
+};
+export type ListResourcesOwnershipEnum = typeof ListResourcesOwnershipEnum[keyof typeof ListResourcesOwnershipEnum];
 /**
  * @export
  */

package/dist/esm/apis/ResourcesApi.js

@@ -27,7 +27,7 @@ import { PaginatedResourcesFromJSON, } from '../models/index';
  */
 export class ResourcesApi extends runtime.BaseAPI {
     /**
-     * Returns the authenticated user\'s quizzes and flashcard sets, newest first, each with its question rollup, originating chat, course attribution, study objective, and session activity. Intended for a library view, so every row carries enough to render a card without a follow-up request.
+     * Returns the authenticated user\'s quizzes and flashcard sets, newest first, each with its question rollup, originating chat, course attribution, study objective, and session activity. Intended for a library view, so every row carries enough to render a card without a follow-up request. By default lists what the user generated; `ownership=shared` lists other learners\' resources the user has opened through a share link, with the owner\'s chat, objective, space, and course withheld.
      * List the user\'s generated study resources
      */
     listResourcesRaw(requestParameters, initOverrides) {
@@ -45,6 +45,9 @@ export class ResourcesApi extends runtime.BaseAPI {
             if (requestParameters['type'] != null) {
                 queryParameters['type'] = requestParameters['type'];
             }
+            if (requestParameters['ownership'] != null) {
+                queryParameters['ownership'] = requestParameters['ownership'];
+            }
             if (requestParameters['courseId'] != null) {
                 queryParameters['courseId'] = requestParameters['courseId'];
             }
@@ -75,7 +78,7 @@ export class ResourcesApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Returns the authenticated user\'s quizzes and flashcard sets, newest first, each with its question rollup, originating chat, course attribution, study objective, and session activity. Intended for a library view, so every row carries enough to render a card without a follow-up request.
+     * Returns the authenticated user\'s quizzes and flashcard sets, newest first, each with its question rollup, originating chat, course attribution, study objective, and session activity. Intended for a library view, so every row carries enough to render a card without a follow-up request. By default lists what the user generated; `ownership=shared` lists other learners\' resources the user has opened through a share link, with the owner\'s chat, objective, space, and course withheld.
      * List the user\'s generated study resources
      */
     listResources(requestParameters, initOverrides) {
@@ -92,6 +95,13 @@ export const ListResourcesTypeEnum = {
     Quiz: 'quiz',
     Flashcards: 'flashcards'
 };
+/**
+ * @export
+ */
+export const ListResourcesOwnershipEnum = {
+    Owned: 'owned',
+    Shared: 'shared'
+};
 /**
  * @export
  */

package/dist/esm/apis/SharedQuizzesApi.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Athena API
+ * REST API for the Athena system
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import * as runtime from '../runtime';
+import type { QuizSession, SharedQuiz } from '../models/index';
+export interface GetSharedQuizRequest {
+    token: string;
+    xUserId: string;
+}
+export interface StartSharedQuizSessionRequest {
+    token: string;
+    xUserId: string;
+}
+/**
+ *
+ */
+export declare class SharedQuizzesApi extends runtime.BaseAPI {
+    /**
+     * Returns the quiz behind a share link: enough to render a landing card and start a session, without identifying the owner.
+     * Resolve a quiz share link
+     */
+    getSharedQuizRaw(requestParameters: GetSharedQuizRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SharedQuiz>>;
+    /**
+     * Returns the quiz behind a share link: enough to render a landing card and start a session, without identifying the owner.
+     * Resolve a quiz share link
+     */
+    getSharedQuiz(requestParameters: GetSharedQuizRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SharedQuiz>;
+    /**
+     * Returns the caller\'s active session on the quiz behind the link, creating one if none is active. The session belongs to the caller; its answers never touch the owner\'s progress. Returns 201 whether the session was created or resumed.
+     * Start or resume the caller\'s session on a shared quiz
+     */
+    startSharedQuizSessionRaw(requestParameters: StartSharedQuizSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<QuizSession>>;
+    /**
+     * Returns the caller\'s active session on the quiz behind the link, creating one if none is active. The session belongs to the caller; its answers never touch the owner\'s progress. Returns 201 whether the session was created or resumed.
+     * Start or resume the caller\'s session on a shared quiz
+     */
+    startSharedQuizSession(requestParameters: StartSharedQuizSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<QuizSession>;
+}

package/dist/esm/apis/SharedQuizzesApi.js

@@ -0,0 +1,111 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Athena API
+ * REST API for the Athena system
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as runtime from '../runtime';
+import { QuizSessionFromJSON, SharedQuizFromJSON, } from '../models/index';
+/**
+ *
+ */
+export class SharedQuizzesApi extends runtime.BaseAPI {
+    /**
+     * Returns the quiz behind a share link: enough to render a landing card and start a session, without identifying the owner.
+     * Resolve a quiz share link
+     */
+    getSharedQuizRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['token'] == null) {
+                throw new runtime.RequiredError('token', 'Required parameter "token" was null or undefined when calling getSharedQuiz().');
+            }
+            if (requestParameters['xUserId'] == null) {
+                throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling getSharedQuiz().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (requestParameters['xUserId'] != null) {
+                headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
+            }
+            let urlPath = `/api/v1/shared-quizzes/{token}`;
+            urlPath = urlPath.replace(`{${"token"}}`, encodeURIComponent(String(requestParameters['token'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => SharedQuizFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Returns the quiz behind a share link: enough to render a landing card and start a session, without identifying the owner.
+     * Resolve a quiz share link
+     */
+    getSharedQuiz(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getSharedQuizRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Returns the caller\'s active session on the quiz behind the link, creating one if none is active. The session belongs to the caller; its answers never touch the owner\'s progress. Returns 201 whether the session was created or resumed.
+     * Start or resume the caller\'s session on a shared quiz
+     */
+    startSharedQuizSessionRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['token'] == null) {
+                throw new runtime.RequiredError('token', 'Required parameter "token" was null or undefined when calling startSharedQuizSession().');
+            }
+            if (requestParameters['xUserId'] == null) {
+                throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling startSharedQuizSession().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (requestParameters['xUserId'] != null) {
+                headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
+            }
+            let urlPath = `/api/v1/shared-quizzes/{token}/sessions`;
+            urlPath = urlPath.replace(`{${"token"}}`, encodeURIComponent(String(requestParameters['token'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => QuizSessionFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Returns the caller\'s active session on the quiz behind the link, creating one if none is active. The session belongs to the caller; its answers never touch the owner\'s progress. Returns 201 whether the session was created or resumed.
+     * Start or resume the caller\'s session on a shared quiz
+     */
+    startSharedQuizSession(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.startSharedQuizSessionRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+}

package/dist/esm/apis/index.d.ts

@@ -20,6 +20,7 @@ export * from './QuizSessionsApi';
 export * from './QuizzesApi';
 export * from './ResourcesApi';
 export * from './ServiceTokensApi';
+export * from './SharedQuizzesApi';
 export * from './StudyObjectiveConceptsApi';
 export * from './StudyObjectivesApi';
 export * from './StudyPlansApi';

package/dist/esm/apis/index.js

@@ -22,6 +22,7 @@ export * from './QuizSessionsApi';
 export * from './QuizzesApi';
 export * from './ResourcesApi';
 export * from './ServiceTokensApi';
+export * from './SharedQuizzesApi';
 export * from './StudyObjectiveConceptsApi';
 export * from './StudyObjectivesApi';
 export * from './StudyPlansApi';

package/dist/esm/models/AdminPaginatedQuizParticipantSessions.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Athena API
+ * REST API for the Athena system
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { AdminQuizParticipantSessionListItem } from './AdminQuizParticipantSessionListItem';
+/**
+ *
+ * @export
+ * @interface AdminPaginatedQuizParticipantSessions
+ */
+export interface AdminPaginatedQuizParticipantSessions {
+    /**
+     *
+     * @type {Array<AdminQuizParticipantSessionListItem>}
+     * @memberof AdminPaginatedQuizParticipantSessions
+     */
+    data: Array<AdminQuizParticipantSessionListItem>;
+    /**
+     * Opaque cursor for fetching the next page. Null when there are no more results.
+     * @type {string}
+     * @memberof AdminPaginatedQuizParticipantSessions
+     */
+    nextCursor: string | null;
+}
+/**
+ * Check if a given object implements the AdminPaginatedQuizParticipantSessions interface.
+ */
+export declare function instanceOfAdminPaginatedQuizParticipantSessions(value: object): value is AdminPaginatedQuizParticipantSessions;
+export declare function AdminPaginatedQuizParticipantSessionsFromJSON(json: any): AdminPaginatedQuizParticipantSessions;
+export declare function AdminPaginatedQuizParticipantSessionsFromJSONTyped(json: any, ignoreDiscriminator: boolean): AdminPaginatedQuizParticipantSessions;
+export declare function AdminPaginatedQuizParticipantSessionsToJSON(json: any): AdminPaginatedQuizParticipantSessions;
+export declare function AdminPaginatedQuizParticipantSessionsToJSONTyped(value?: AdminPaginatedQuizParticipantSessions | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/AdminPaginatedQuizParticipantSessions.js

@@ -0,0 +1,48 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Athena API
+ * REST API for the Athena system
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import { AdminQuizParticipantSessionListItemFromJSON, AdminQuizParticipantSessionListItemToJSON, } from './AdminQuizParticipantSessionListItem';
+/**
+ * Check if a given object implements the AdminPaginatedQuizParticipantSessions interface.
+ */
+export function instanceOfAdminPaginatedQuizParticipantSessions(value) {
+    if (!('data' in value) || value['data'] === undefined)
+        return false;
+    if (!('nextCursor' in value) || value['nextCursor'] === undefined)
+        return false;
+    return true;
+}
+export function AdminPaginatedQuizParticipantSessionsFromJSON(json) {
+    return AdminPaginatedQuizParticipantSessionsFromJSONTyped(json, false);
+}
+export function AdminPaginatedQuizParticipantSessionsFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'data': (json['data'].map(AdminQuizParticipantSessionListItemFromJSON)),
+        'nextCursor': json['nextCursor'],
+    };
+}
+export function AdminPaginatedQuizParticipantSessionsToJSON(json) {
+    return AdminPaginatedQuizParticipantSessionsToJSONTyped(json, false);
+}
+export function AdminPaginatedQuizParticipantSessionsToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'data': (value['data'].map(AdminQuizParticipantSessionListItemToJSON)),
+        'nextCursor': value['nextCursor'],
+    };
+}