Skip to content
KajayDocs
ReferenceSDK neutral

Diagnostics

Stable definition, expression, dependency, and survey-error identifiers.

Diagnostic codes are stable lookup keys. Survey errors are extensible; the other categories below are the built-in runtime catalog.

definition diagnostics

definition diagnostics
CodePhase / severityMeaning
unknown-propertywarningA property is not registered; it is preserved verbatim.
property-type-mismatcherrorA registered property contains a value of the wrong JSON type.
invalid-child-collectionerrorA registered child collection is not an array.
invalid-elementerrorA child entry is neither an object nor an allowed scalar shorthand.
unknown-element-typeerrorA child declares a type that is not valid for its collection.
undeclared-endpointerrorA definition references a deployment endpoint the host did not supply.
invalid-patternerrorA validation pattern is outside Kajay Pattern Profile v1.
undeclared-host-valuewarningAn expression reads a host value the host did not supply.
undeclared-blankerrorA fill-in-the-blank template positions a blank its question does not declare.
unpositioned-blankwarningA fill-in-the-blank question declares a blank its template never positions.
non-inline-blankerrorA fill-in-the-blank positions a blank whose type cannot sit inline.
locale-blank-mismatcherrorA translated fill-in-the-blank template names a different set of blanks.
reserved-name-sigilerrorAn element name starts with the sigil reserved for the host-value scope.

expression diagnostics

expression diagnostics
CodePhase / severityMeaning
unterminated-stringparseA string has no closing quote.
unterminated-referenceparseA reference has no closing brace.
unexpected-characterparseThe tokenizer encountered a character outside the grammar.
invalid-reference-indexparseA reference index is not a non-negative integer.
empty-referenceparseA reference contains no path.
empty-expressionparseThe expression is empty.
unexpected-trailing-inputparseValid input is followed by an unexpected token.
invalid-numberparseA numeric token is not finite.
unexpected-endparseThe expression ended where an operand was required.
unknown-identifierparseA bare identifier is neither a literal nor a function call.
unexpected-tokenparseA token cannot begin an operand.
unclosed-groupparseA group or array is not closed.
unparsed-expressionevaluateEvaluation reached an error node produced by parsing.
unknown-functionevaluateA call names no registered expression function.
async-unavailableevaluateAn asynchronous function was evaluated without an asynchronous value source.
function-failedevaluateAn asynchronous expression function rejected or threw.

dependency diagnostics

dependency diagnostics
CodePhase / severityMeaning
cycleRuntimeThe dependency graph contains a cycle.
cascade-limitRuntimeA dependency transaction exceeded its configured settle limit.

survey diagnostics

survey diagnostics
CodePhase / severityMeaning
requiredRuntimeA required question has no answer.
minLengthRuntimeA comment answer is shorter than its minimum.
maxLengthRuntimeA text or comment answer exceeds its maximum.
minRuntimeA numeric or date answer is below its lower bound.
maxRuntimeA numeric or date answer is above its upper bound.
numericvalidatorRuntimeThe built-in numeric validator failed.
textvalidatorRuntimeThe built-in text validator failed.
regexvalidatorRuntimeThe built-in regular-expression validator failed.
emailvalidatorRuntimeThe built-in email validator failed.
expressionvalidatorRuntimeThe built-in expression validator failed.
answercountvalidatorRuntimeThe built-in answer-count validator failed.
eachrowuniqueRuntimeA matrix row repeats another row's answer.
filetoolargeRuntimeAn attached file exceeds the authored size limit.
filewrongtypeRuntimeAn attached file does not match the accepted types.
filetoomanyRuntimeA file answer exceeds the authored file-count limit.
hostRuntimeA synchronous host validation listener rejected the answer.
serverRuntimeAn asynchronous server validation result rejected the answer.