{"record":{"id":"d83593e1da266169","repo":"jlcodes99/cockpit-tools","slug":"accountgroups-stored-data-must-be-a-json-array","errorCode":null,"errorMessage":"[AccountGroups] Stored data must be a JSON array","messagePattern":"\\[AccountGroups\\] Stored data must be a JSON array","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"src/services/accountGroupService.ts","lineNumber":55,"sourceCode":"}\n\nfunction cloneGroups(groups: AccountGroup[]): AccountGroup[] {\n  return groups.map((group) => ({\n    ...group,\n    accountIds: [...group.accountIds],\n  }));\n}\n\nfunction parseGroups(raw: string): AccountGroup[] {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch (error) {\n    throw new Error(`[AccountGroups] Invalid JSON: ${String(error)}`);\n  }\n\n  if (!Array.isArray(parsed)) {\n    throw new Error('[AccountGroups] Stored data must be a JSON array');\n  }\n\n  const groups = parsed.map((value, index) => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) {\n      throw new Error(`[AccountGroups] Invalid group at index ${index}`);\n    }\n\n    const group = value as Record<string, unknown>;\n    if (typeof group.id !== 'string' || !group.id.trim()) {\n      throw new Error(`[AccountGroups] Group ${index} has an invalid id`);\n    }\n    if (typeof group.name !== 'string') {\n      throw new Error(`[AccountGroups] Group ${index} has an invalid name`);\n    }\n    if (!Array.isArray(group.accountIds) || group.accountIds.some((id) => typeof id !== 'string')) {\n      throw new Error(`[AccountGroups] Group ${index} has invalid account ids`);\n    }\n","sourceCodeStart":37,"sourceCodeEnd":73,"githubUrl":"https://github.com/jlcodes99/cockpit-tools/blob/1ed8b77992d62ca81fabf744deb0839ad361d5bf/src/services/accountGroupService.ts#L37-L73","documentation":"Validation in parseGroups: the stored account-groups file parsed as valid JSON but its root is not an array (e.g. an object or scalar). The persistence contract requires a JSON array of group objects, so any other root shape is rejected as corrupt storage.","triggerScenarios":"Thrown at src/services/accountGroupService.ts:55 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Restore the groups file from backup; the root must be a JSON array","If the file was hand-edited, wrap the group entries in an array","Verify the saving side always serializes AccountGroup[] and not a wrapper object"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"1ed8b77992d62ca81fabf744deb0839ad361d5bf","analyzedAt":"2026-09-05T09:51:41.178Z","contentChangedAt":"2026-09-05T09:51:41.178Z","schemaVersion":2},"datasetVersion":"2026-09-12T12:17:11.808Z"}