@wix/auto_sdk_online-programs_quizzes 1.0.27 → 1.0.28

package/build/internal/cjs/index.d.ts

@@ -5,7 +5,7 @@ export { AccountInfo, ActionEvent, ApplicationError, BulkActionMetadata, BulkClo
 declare function createQuiz$1(httpClient: HttpClient): CreateQuizSignature;
 interface CreateQuizSignature {
     /**
-     * Creates a detached quiz definition.
+     * Creates a detached quiz definition with at least one question.
      *
      * To use the quiz in an Online Program, pass the returned quiz ID as `step.quizOptions.id` when calling the Steps API's `CreateStep` or `BulkCreateSteps` method.
      * @param - Quiz definition to create. Generate a stable unique GUID for every `quiz.fields.id` value.
@@ -20,6 +20,8 @@ interface CloneQuizSignature {
     /**
      * Clones a quiz definition and returns a new quiz ID.
      *
+     * Checks the source before cloning. An existing definition found to have no active questions is rejected with INVALID_QUIZ before cloning. Source checks aren't atomic with cloning.
+     *
      * This operation copies the question and settings definition only. It doesn't copy Online Programs step associations or quiz submissions. Attach the returned ID to a step separately when needed.
      * @param - ID of the quiz definition to clone.
      */
@@ -30,7 +32,7 @@ interface CloneQuizSignature {
 declare function bulkCreateQuizzes$1(httpClient: HttpClient): BulkCreateQuizzesSignature;
 interface BulkCreateQuizzesSignature {
     /**
-     * Creates up to 30 detached quiz definitions in a single API call.
+     * Creates up to 30 detached quiz definitions in a single API call. Each definition must contain at least one question.
      *
      * Quiz IDs, revisions, and creation and update timestamps are assigned by the server. Client-supplied values for these read-only fields are ignored. Question IDs (`quizzes.fields.id`) must be supplied by the caller.
      *
@@ -48,7 +50,7 @@ interface BulkCreateQuizzesSignature {
 declare function getQuiz$1(httpClient: HttpClient): GetQuizSignature;
 interface GetQuizSignature {
     /**
-     * Retrieves a quiz definition by ID.
+     * Retrieves a quiz definition by ID. A stored definition whose questions have all been deleted can be returned with no active questions.
      *
      * To discover a quiz ID, query or retrieve its quiz-type Online Programs step and read `step.quizOptions.id`.
      * @param - Quiz ID, available from `step.quizOptions.id` on a quiz-type Online Programs step.

package/build/internal/cjs/index.typings.d.ts

@@ -34,7 +34,9 @@ interface Quiz {
      */
     _updatedDate?: Date | null;
     /**
-     * Questions in the quiz. Each `QuizField` defines one question and its answer input. New submissions use the current questions; stored submissions retain their recorded answer evaluations.
+     * Active questions in the quiz. Each `QuizField` defines one question and its answer input. Creating a quiz requires at least one question. An existing definition can have no active questions after its questions are deleted through another supported workflow; retrieving that definition doesn't fail solely because this list is empty.
+     *
+     * New submissions use the current questions; stored submissions retain their recorded answer evaluations. Reading an empty definition doesn't imply that it can be used to create a new quiz or accept submissions.
      * @minSize 1
      * @maxSize 200
      */
@@ -135,12 +137,18 @@ declare enum FileUploadFormat {
 /** @enumType */
 type FileUploadFormatWithLiterals = FileUploadFormat | 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT' | 'ARCHIVE' | 'MODEL_3D';
 interface NumericField {
-    /** Correct numeric value. Matching is exact. If omitted, the answer is non-evaluable and counts as correct when calculating the earned grade. */
+    /**
+     * Correct numeric value. Matching is exact. If no correct value is stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Omitted from responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove the stored key or change grading; an absent response value doesn't mean no correct value is stored.
+     */
     rightAnswer?: number | null;
 }
 interface ShortTextField {
     /**
-     * Correct text. Matching trims leading and trailing whitespace and is case-insensitive. If omitted, the answer is non-evaluable and counts as correct when calculating the earned grade.
+     * Correct text. Matching trims leading and trailing whitespace and is case-insensitive. If no correct text is stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Omitted from responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove the stored key or change grading; an absent response value doesn't mean no correct text is stored.
      * @minLength 1
      * @maxLength 200
      */
@@ -151,13 +159,15 @@ interface LongTextField {
 }
 interface SingleChoiceField {
     /**
-     * Correct option. Matching is exact. If omitted, the answer is non-evaluable and counts as correct when calculating the earned grade.
+     * Correct option. When supplied, it must exactly match an entry in `options`; otherwise, creation fails with INVALID_QUIZ. Matching submitted answers is exact. If no correct option is stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Omitted from responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove the stored key or change grading; an absent response value doesn't mean no correct option is stored.
      * @minLength 1
      * @maxLength 350
      */
     rightAnswer?: string | null;
     /**
-     * Options available to the participant.
+     * Options available to the participant. Labels must be unique; comparison is case-sensitive. Duplicate labels are rejected with INVALID_QUIZ before creation.
      * @minSize 1
      * @maxSize 90
      * @minLength 1
@@ -165,11 +175,12 @@ interface SingleChoiceField {
      */
     options?: string[] | null;
 }
+/** Multiple-choice input settings. Existing Wix Forms image-choice questions are also returned in this shape, even when their original settings allow only one selection. Image-choice-specific settings aren't exposed by the Quiz API. */
 interface MultiChoiceField {
     /**
-     * Returned only with achievements:quizzes:v1:quiz:read_sensitive_fields permission.
-     * Repeated fields cannot use conditional annotations; the service redacts this field.
-     * Correct options. Matching ignores option order but doesn't ignore duplicate values. If omitted, the answer is non-evaluable and counts as correct when calculating the earned grade.
+     * Correct options. Every supplied value must exactly match an entry in `options`; otherwise, creation fails with INVALID_QUIZ. Matching submitted answers ignores option order but doesn't ignore duplicate values. If no correct options are stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Empty in responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove stored keys or change grading; an empty response list doesn't mean no correct options are stored.
      * @maxSize 90
      * @minLength 1
      * @maxLength 350
@@ -517,6 +528,10 @@ type CreateQuizApplicationErrors = {
 };
 /** @docsIgnore */
 type CloneQuizApplicationErrors = {
+    code?: 'INVALID_QUIZ';
+    description?: string;
+    data?: Record<string, any>;
+} | {
     code?: 'QUIZ_NOT_FOUND';
     description?: string;
     data?: Record<string, any>;
@@ -548,7 +563,7 @@ type DeleteQuizApplicationErrors = {
     data?: Record<string, any>;
 };
 /**
- * Creates a detached quiz definition.
+ * Creates a detached quiz definition with at least one question.
  *
  * To use the quiz in an Online Program, pass the returned quiz ID as `step.quizOptions.id` when calling the Steps API's `CreateStep` or `BulkCreateSteps` method.
  * @param quiz - Quiz definition to create. Generate a stable unique GUID for every `quiz.fields.id` value.
@@ -572,6 +587,8 @@ declare function createQuiz(quiz: NonNullablePaths<Quiz, `fields` | `fields.${nu
 /**
  * Clones a quiz definition and returns a new quiz ID.
  *
+ * Checks the source before cloning. An existing definition found to have no active questions is rejected with INVALID_QUIZ before cloning. Source checks aren't atomic with cloning.
+ *
  * This operation copies the question and settings definition only. It doesn't copy Online Programs step associations or quiz submissions. Attach the returned ID to a step separately when needed.
  * @param quizId - ID of the quiz definition to clone.
  * @public
@@ -584,7 +601,7 @@ declare function cloneQuiz(quizId: string): Promise<NonNullablePaths<CloneQuizRe
     __applicationErrorsType?: CloneQuizApplicationErrors;
 }>;
 /**
- * Creates up to 30 detached quiz definitions in a single API call.
+ * Creates up to 30 detached quiz definitions in a single API call. Each definition must contain at least one question.
  *
  * Quiz IDs, revisions, and creation and update timestamps are assigned by the server. Client-supplied values for these read-only fields are ignored. Question IDs (`quizzes.fields.id`) must be supplied by the caller.
  *
@@ -620,7 +637,7 @@ interface BulkCreateQuizzesOptions {
     returnEntity?: boolean;
 }
 /**
- * Retrieves a quiz definition by ID.
+ * Retrieves a quiz definition by ID. A stored definition whose questions have all been deleted can be returned with no active questions.
  *
  * To discover a quiz ID, query or retrieve its quiz-type Online Programs step and read `step.quizOptions.id`.
  * @param quizId - Quiz ID, available from `step.quizOptions.id` on a quiz-type Online Programs step.

package/build/internal/cjs/meta.d.ts

@@ -35,7 +35,9 @@ interface Quiz {
      */
     updatedDate?: Date | null;
     /**
-     * Questions in the quiz. Each `QuizField` defines one question and its answer input. New submissions use the current questions; stored submissions retain their recorded answer evaluations.
+     * Active questions in the quiz. Each `QuizField` defines one question and its answer input. Creating a quiz requires at least one question. An existing definition can have no active questions after its questions are deleted through another supported workflow; retrieving that definition doesn't fail solely because this list is empty.
+     *
+     * New submissions use the current questions; stored submissions retain their recorded answer evaluations. Reading an empty definition doesn't imply that it can be used to create a new quiz or accept submissions.
      * @minSize 1
      * @maxSize 200
      */
@@ -136,12 +138,18 @@ declare enum FileUploadFormat {
 /** @enumType */
 type FileUploadFormatWithLiterals = FileUploadFormat | 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT' | 'ARCHIVE' | 'MODEL_3D';
 interface NumericField {
-    /** Correct numeric value. Matching is exact. If omitted, the answer is non-evaluable and counts as correct when calculating the earned grade. */
+    /**
+     * Correct numeric value. Matching is exact. If no correct value is stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Omitted from responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove the stored key or change grading; an absent response value doesn't mean no correct value is stored.
+     */
     rightAnswer?: number | null;
 }
 interface ShortTextField {
     /**
-     * Correct text. Matching trims leading and trailing whitespace and is case-insensitive. If omitted, the answer is non-evaluable and counts as correct when calculating the earned grade.
+     * Correct text. Matching trims leading and trailing whitespace and is case-insensitive. If no correct text is stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Omitted from responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove the stored key or change grading; an absent response value doesn't mean no correct text is stored.
      * @minLength 1
      * @maxLength 200
      */
@@ -152,13 +160,15 @@ interface LongTextField {
 }
 interface SingleChoiceField {
     /**
-     * Correct option. Matching is exact. If omitted, the answer is non-evaluable and counts as correct when calculating the earned grade.
+     * Correct option. When supplied, it must exactly match an entry in `options`; otherwise, creation fails with INVALID_QUIZ. Matching submitted answers is exact. If no correct option is stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Omitted from responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove the stored key or change grading; an absent response value doesn't mean no correct option is stored.
      * @minLength 1
      * @maxLength 350
      */
     rightAnswer?: string | null;
     /**
-     * Options available to the participant.
+     * Options available to the participant. Labels must be unique; comparison is case-sensitive. Duplicate labels are rejected with INVALID_QUIZ before creation.
      * @minSize 1
      * @maxSize 90
      * @minLength 1
@@ -166,11 +176,12 @@ interface SingleChoiceField {
      */
     options?: string[] | null;
 }
+/** Multiple-choice input settings. Existing Wix Forms image-choice questions are also returned in this shape, even when their original settings allow only one selection. Image-choice-specific settings aren't exposed by the Quiz API. */
 interface MultiChoiceField {
     /**
-     * Returned only with achievements:quizzes:v1:quiz:read_sensitive_fields permission.
-     * Repeated fields cannot use conditional annotations; the service redacts this field.
-     * Correct options. Matching ignores option order but doesn't ignore duplicate values. If omitted, the answer is non-evaluable and counts as correct when calculating the earned grade.
+     * Correct options. Every supplied value must exactly match an entry in `options`; otherwise, creation fails with INVALID_QUIZ. Matching submitted answers ignores option order but doesn't ignore duplicate values. If no correct options are stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Empty in responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove stored keys or change grading; an empty response list doesn't mean no correct options are stored.
      * @maxSize 90
      * @minLength 1
      * @maxLength 350
@@ -562,6 +573,10 @@ type CreateQuizApplicationErrors = {
 };
 /** @docsIgnore */
 type CloneQuizApplicationErrors = {
+    code?: 'INVALID_QUIZ';
+    description?: string;
+    data?: Record<string, any>;
+} | {
     code?: 'QUIZ_NOT_FOUND';
     description?: string;
     data?: Record<string, any>;

package/build/internal/es/index.d.mts

@@ -5,7 +5,7 @@ export { AccountInfo, ActionEvent, ApplicationError, BulkActionMetadata, BulkClo
 declare function createQuiz$1(httpClient: HttpClient): CreateQuizSignature;
 interface CreateQuizSignature {
     /**
-     * Creates a detached quiz definition.
+     * Creates a detached quiz definition with at least one question.
      *
      * To use the quiz in an Online Program, pass the returned quiz ID as `step.quizOptions.id` when calling the Steps API's `CreateStep` or `BulkCreateSteps` method.
      * @param - Quiz definition to create. Generate a stable unique GUID for every `quiz.fields.id` value.
@@ -20,6 +20,8 @@ interface CloneQuizSignature {
     /**
      * Clones a quiz definition and returns a new quiz ID.
      *
+     * Checks the source before cloning. An existing definition found to have no active questions is rejected with INVALID_QUIZ before cloning. Source checks aren't atomic with cloning.
+     *
      * This operation copies the question and settings definition only. It doesn't copy Online Programs step associations or quiz submissions. Attach the returned ID to a step separately when needed.
      * @param - ID of the quiz definition to clone.
      */
@@ -30,7 +32,7 @@ interface CloneQuizSignature {
 declare function bulkCreateQuizzes$1(httpClient: HttpClient): BulkCreateQuizzesSignature;
 interface BulkCreateQuizzesSignature {
     /**
-     * Creates up to 30 detached quiz definitions in a single API call.
+     * Creates up to 30 detached quiz definitions in a single API call. Each definition must contain at least one question.
      *
      * Quiz IDs, revisions, and creation and update timestamps are assigned by the server. Client-supplied values for these read-only fields are ignored. Question IDs (`quizzes.fields.id`) must be supplied by the caller.
      *
@@ -48,7 +50,7 @@ interface BulkCreateQuizzesSignature {
 declare function getQuiz$1(httpClient: HttpClient): GetQuizSignature;
 interface GetQuizSignature {
     /**
-     * Retrieves a quiz definition by ID.
+     * Retrieves a quiz definition by ID. A stored definition whose questions have all been deleted can be returned with no active questions.
      *
      * To discover a quiz ID, query or retrieve its quiz-type Online Programs step and read `step.quizOptions.id`.
      * @param - Quiz ID, available from `step.quizOptions.id` on a quiz-type Online Programs step.

package/build/internal/es/index.typings.d.mts

@@ -34,7 +34,9 @@ interface Quiz {
      */
     _updatedDate?: Date | null;
     /**
-     * Questions in the quiz. Each `QuizField` defines one question and its answer input. New submissions use the current questions; stored submissions retain their recorded answer evaluations.
+     * Active questions in the quiz. Each `QuizField` defines one question and its answer input. Creating a quiz requires at least one question. An existing definition can have no active questions after its questions are deleted through another supported workflow; retrieving that definition doesn't fail solely because this list is empty.
+     *
+     * New submissions use the current questions; stored submissions retain their recorded answer evaluations. Reading an empty definition doesn't imply that it can be used to create a new quiz or accept submissions.
      * @minSize 1
      * @maxSize 200
      */
@@ -135,12 +137,18 @@ declare enum FileUploadFormat {
 /** @enumType */
 type FileUploadFormatWithLiterals = FileUploadFormat | 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT' | 'ARCHIVE' | 'MODEL_3D';
 interface NumericField {
-    /** Correct numeric value. Matching is exact. If omitted, the answer is non-evaluable and counts as correct when calculating the earned grade. */
+    /**
+     * Correct numeric value. Matching is exact. If no correct value is stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Omitted from responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove the stored key or change grading; an absent response value doesn't mean no correct value is stored.
+     */
     rightAnswer?: number | null;
 }
 interface ShortTextField {
     /**
-     * Correct text. Matching trims leading and trailing whitespace and is case-insensitive. If omitted, the answer is non-evaluable and counts as correct when calculating the earned grade.
+     * Correct text. Matching trims leading and trailing whitespace and is case-insensitive. If no correct text is stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Omitted from responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove the stored key or change grading; an absent response value doesn't mean no correct text is stored.
      * @minLength 1
      * @maxLength 200
      */
@@ -151,13 +159,15 @@ interface LongTextField {
 }
 interface SingleChoiceField {
     /**
-     * Correct option. Matching is exact. If omitted, the answer is non-evaluable and counts as correct when calculating the earned grade.
+     * Correct option. When supplied, it must exactly match an entry in `options`; otherwise, creation fails with INVALID_QUIZ. Matching submitted answers is exact. If no correct option is stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Omitted from responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove the stored key or change grading; an absent response value doesn't mean no correct option is stored.
      * @minLength 1
      * @maxLength 350
      */
     rightAnswer?: string | null;
     /**
-     * Options available to the participant.
+     * Options available to the participant. Labels must be unique; comparison is case-sensitive. Duplicate labels are rejected with INVALID_QUIZ before creation.
      * @minSize 1
      * @maxSize 90
      * @minLength 1
@@ -165,11 +175,12 @@ interface SingleChoiceField {
      */
     options?: string[] | null;
 }
+/** Multiple-choice input settings. Existing Wix Forms image-choice questions are also returned in this shape, even when their original settings allow only one selection. Image-choice-specific settings aren't exposed by the Quiz API. */
 interface MultiChoiceField {
     /**
-     * Returned only with achievements:quizzes:v1:quiz:read_sensitive_fields permission.
-     * Repeated fields cannot use conditional annotations; the service redacts this field.
-     * Correct options. Matching ignores option order but doesn't ignore duplicate values. If omitted, the answer is non-evaluable and counts as correct when calculating the earned grade.
+     * Correct options. Every supplied value must exactly match an entry in `options`; otherwise, creation fails with INVALID_QUIZ. Matching submitted answers ignores option order but doesn't ignore duplicate values. If no correct options are stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Empty in responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove stored keys or change grading; an empty response list doesn't mean no correct options are stored.
      * @maxSize 90
      * @minLength 1
      * @maxLength 350
@@ -517,6 +528,10 @@ type CreateQuizApplicationErrors = {
 };
 /** @docsIgnore */
 type CloneQuizApplicationErrors = {
+    code?: 'INVALID_QUIZ';
+    description?: string;
+    data?: Record<string, any>;
+} | {
     code?: 'QUIZ_NOT_FOUND';
     description?: string;
     data?: Record<string, any>;
@@ -548,7 +563,7 @@ type DeleteQuizApplicationErrors = {
     data?: Record<string, any>;
 };
 /**
- * Creates a detached quiz definition.
+ * Creates a detached quiz definition with at least one question.
  *
  * To use the quiz in an Online Program, pass the returned quiz ID as `step.quizOptions.id` when calling the Steps API's `CreateStep` or `BulkCreateSteps` method.
  * @param quiz - Quiz definition to create. Generate a stable unique GUID for every `quiz.fields.id` value.
@@ -572,6 +587,8 @@ declare function createQuiz(quiz: NonNullablePaths<Quiz, `fields` | `fields.${nu
 /**
  * Clones a quiz definition and returns a new quiz ID.
  *
+ * Checks the source before cloning. An existing definition found to have no active questions is rejected with INVALID_QUIZ before cloning. Source checks aren't atomic with cloning.
+ *
  * This operation copies the question and settings definition only. It doesn't copy Online Programs step associations or quiz submissions. Attach the returned ID to a step separately when needed.
  * @param quizId - ID of the quiz definition to clone.
  * @public
@@ -584,7 +601,7 @@ declare function cloneQuiz(quizId: string): Promise<NonNullablePaths<CloneQuizRe
     __applicationErrorsType?: CloneQuizApplicationErrors;
 }>;
 /**
- * Creates up to 30 detached quiz definitions in a single API call.
+ * Creates up to 30 detached quiz definitions in a single API call. Each definition must contain at least one question.
  *
  * Quiz IDs, revisions, and creation and update timestamps are assigned by the server. Client-supplied values for these read-only fields are ignored. Question IDs (`quizzes.fields.id`) must be supplied by the caller.
  *
@@ -620,7 +637,7 @@ interface BulkCreateQuizzesOptions {
     returnEntity?: boolean;
 }
 /**
- * Retrieves a quiz definition by ID.
+ * Retrieves a quiz definition by ID. A stored definition whose questions have all been deleted can be returned with no active questions.
  *
  * To discover a quiz ID, query or retrieve its quiz-type Online Programs step and read `step.quizOptions.id`.
  * @param quizId - Quiz ID, available from `step.quizOptions.id` on a quiz-type Online Programs step.

package/build/internal/es/meta.d.mts

@@ -35,7 +35,9 @@ interface Quiz {
      */
     updatedDate?: Date | null;
     /**
-     * Questions in the quiz. Each `QuizField` defines one question and its answer input. New submissions use the current questions; stored submissions retain their recorded answer evaluations.
+     * Active questions in the quiz. Each `QuizField` defines one question and its answer input. Creating a quiz requires at least one question. An existing definition can have no active questions after its questions are deleted through another supported workflow; retrieving that definition doesn't fail solely because this list is empty.
+     *
+     * New submissions use the current questions; stored submissions retain their recorded answer evaluations. Reading an empty definition doesn't imply that it can be used to create a new quiz or accept submissions.
      * @minSize 1
      * @maxSize 200
      */
@@ -136,12 +138,18 @@ declare enum FileUploadFormat {
 /** @enumType */
 type FileUploadFormatWithLiterals = FileUploadFormat | 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT' | 'ARCHIVE' | 'MODEL_3D';
 interface NumericField {
-    /** Correct numeric value. Matching is exact. If omitted, the answer is non-evaluable and counts as correct when calculating the earned grade. */
+    /**
+     * Correct numeric value. Matching is exact. If no correct value is stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Omitted from responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove the stored key or change grading; an absent response value doesn't mean no correct value is stored.
+     */
     rightAnswer?: number | null;
 }
 interface ShortTextField {
     /**
-     * Correct text. Matching trims leading and trailing whitespace and is case-insensitive. If omitted, the answer is non-evaluable and counts as correct when calculating the earned grade.
+     * Correct text. Matching trims leading and trailing whitespace and is case-insensitive. If no correct text is stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Omitted from responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove the stored key or change grading; an absent response value doesn't mean no correct text is stored.
      * @minLength 1
      * @maxLength 200
      */
@@ -152,13 +160,15 @@ interface LongTextField {
 }
 interface SingleChoiceField {
     /**
-     * Correct option. Matching is exact. If omitted, the answer is non-evaluable and counts as correct when calculating the earned grade.
+     * Correct option. When supplied, it must exactly match an entry in `options`; otherwise, creation fails with INVALID_QUIZ. Matching submitted answers is exact. If no correct option is stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Omitted from responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove the stored key or change grading; an absent response value doesn't mean no correct option is stored.
      * @minLength 1
      * @maxLength 350
      */
     rightAnswer?: string | null;
     /**
-     * Options available to the participant.
+     * Options available to the participant. Labels must be unique; comparison is case-sensitive. Duplicate labels are rejected with INVALID_QUIZ before creation.
      * @minSize 1
      * @maxSize 90
      * @minLength 1
@@ -166,11 +176,12 @@ interface SingleChoiceField {
      */
     options?: string[] | null;
 }
+/** Multiple-choice input settings. Existing Wix Forms image-choice questions are also returned in this shape, even when their original settings allow only one selection. Image-choice-specific settings aren't exposed by the Quiz API. */
 interface MultiChoiceField {
     /**
-     * Returned only with achievements:quizzes:v1:quiz:read_sensitive_fields permission.
-     * Repeated fields cannot use conditional annotations; the service redacts this field.
-     * Correct options. Matching ignores option order but doesn't ignore duplicate values. If omitted, the answer is non-evaluable and counts as correct when calculating the earned grade.
+     * Correct options. Every supplied value must exactly match an entry in `options`; otherwise, creation fails with INVALID_QUIZ. Matching submitted answers ignores option order but doesn't ignore duplicate values. If no correct options are stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Empty in responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove stored keys or change grading; an empty response list doesn't mean no correct options are stored.
      * @maxSize 90
      * @minLength 1
      * @maxLength 350
@@ -562,6 +573,10 @@ type CreateQuizApplicationErrors = {
 };
 /** @docsIgnore */
 type CloneQuizApplicationErrors = {
+    code?: 'INVALID_QUIZ';
+    description?: string;
+    data?: Record<string, any>;
+} | {
     code?: 'QUIZ_NOT_FOUND';
     description?: string;
     data?: Record<string, any>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/auto_sdk_online-programs_quizzes",
-  "version": "1.0.27",
+  "version": "1.0.28",
   "license": "MIT",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -50,5 +50,5 @@
       "fqdn": "wix.achievements.quizzes.v1.quiz"
     }
   },
-  "falconPackageHash": "fa76ced103588167557a2a5014138b55c70f8b00881bb172556b69c4"
+  "falconPackageHash": "c296504c5661d6c1f7de3ba10865540325d0e9582bef7e5900770fb8"
 }