Item update FAILS - error message contains broken link - need help / would like to fix docs

[iOSonntag]

Describe the bug I am trying to update an item in a transaction but it fails for some reason:

I expect this to work:

Question.update({
  categoryId: categoryId,
  questionId: questionId,
})
.set({
  enabled: false,
})
.where((attr, op) => op.eq(attr.enabled, true))
...

but only this works:

Question.update({
  categoryId: categoryId,
  questionId: questionId,
})
.set({
  enabled: false,
  type: 'TEXT', // added this
})
.where((attr, op) => op.eq(attr.enabled, true))
.where((attr, op) => op.eq(attr.type, 'TEXT')) // and this to ensure consistency
...

The error in the console says the following - and I have no clue on why I need to supply this value if I am not changing it and unfortunately the link in the error message is broken.

|  +1343ms An unknown error occurred: ElectroError: Incomplete composite attributes: 
Without the composite attributes "type" the following access patterns cannot be updated:
"byTypeCategoryIdEnabled_questionId_KEYS_ONLY". 
If a composite attribute is readOnly and cannot be set, use the 'composite' chain method 
on update to supply the value for key formatting purposes. - For more detail on this error 
reference: https://electrodb.dev/en/reference/errors/#incomplete-composite-attributes

I would like to learn more on why I need to add this, but I cant find it in the documentation, any help would be appreciated, If I am guided in the right direction, I would send a Pull Request to fix the docs afterwards.

ElectroDB Version Specify the version of ElectroDB you are using 2.14.0

Entity/Service Definitions Include your entity model (or a model that sufficiently recreates your issue) to help troubleshoot.

export const QuestionTypes = ['TEXT', 'IMAGE'] as const;
export const RetrievedAtFormats = ['DAY', 'MONTH', 'YEAR'] as const;
export type QuestionType = typeof QuestionTypes[number];
export type QuestionEntity = EntityItem<typeof Question>;
export type CreateQuestionEntity = CreateEntityItem<typeof Question>;

export const Question = new Entity({
  model: {
    entity: 'Question',
    service: 'uquiz',
    version: '1',
  },
  attributes: {
    categoryId: {
      type: 'string',
      required: true,
    },
    questionId: {
      type: 'number',
      required: true,
      padding: {
        length: 12,
        char: '0',
      },
    },
    type: {
      type: QuestionTypes,
      required: true,
    },
    question: {
      type: 'string',
      required: true,
    },
    enabled: {
      type: 'boolean',
      required: true,
    },
    image: S3File,
    mediaSource: {
      type: 'map',
      properties: {
        name: {
          type: 'string',
          required: true,
        },
        url: {
          type: 'string',
          required: true,
        },
      },
    },
    retrieved: {
      type: 'map',
      properties: {
        at: {
          type: 'string',
          required: true,
        },
        format: {
          type: RetrievedAtFormats,
          required: true,
        },
      },
    },
    correct: {
      type: 'string',
      required: true,
    },
    incorrect0: {
      type: 'string',
      required: true,
    },
    incorrect1: {
      type: 'string',
      required: true,
    },
    incorrect2: {
      type: 'string',
      required: true,
    },
    played: {
      type: 'number',
      default: 0,
      required: true,
    },
    playedCorrectly: {
      type: 'number',
      default: 0,
      required: true,
    },
    successRate: {
      type: 'number',
      default: 1,
      required: true,
    },
    createdAt: CommonFields.createdAt,
    updatedAt: CommonFields.updatedAt,
  },
  indexes: {
    question: {
      scope: 'question',
      pk: {
        field: 'pk',
        composite: ['categoryId'],
      },
      sk: {
        field: 'sk',
        composite: ['questionId'],
      },
    },
    byTypeCategoryIdEnabled_questionId_KEYS_ONLY: {
      index: 'kgsi1',
      pk: {
        field: 'kgsi1_pk',
        composite: ['type', 'categoryId', 'enabled'],
      },
      sk: {
        field: 'kgsi1_sk',
        composite: ['questionId'],
      },
    },
    by_categoryIdquestionId_KEYS_ONLY: {
      index: 'kgsi2',
      scope: 'question',
      pk: {
        field: 'kgsi2_pk',
        composite: [],
      },
      sk: {
        field: 'kgsi2_sk',
        composite: ['categoryId', 'questionId'],
      },
    },
    byCorrect_categoryIdquestionId_KEYS_ONLY: {
      index: 'kgsi3',
      scope: 'question',
      pk: {
        field: 'kgsi3_pk',
        composite: ['correct'],
      },
      sk: {
        field: 'kgsi3_sk',
        composite: ['categoryId', 'questionId'],
      },
    },
    byCategoryIdQuestion_questionId_KEYS_ONLY: {
      index: 'kgsi4',
      scope: 'question',
      pk: {
        field: 'kgsi4_pk',
        composite: ['categoryId', 'question'],
      },
      sk: {
        field: 'kgsi4_sk',
        composite: ['questionId'],
      },
    }
  },
}, entityConfig);