{"record":{"id":"6f272137d037db43","repo":"chatboxai/chatbox","slug":"session-references-an-unknown-resource-resource","errorCode":null,"errorMessage":"Session references an unknown resource: ${resourceId}","messagePattern":"Session references an unknown resource: (.+?)","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"src/renderer/packages/backup/types.ts","lineNumber":132,"sourceCode":"      if (ownSessionIds.has(sessionId)) throw new Error(`Resource contains a duplicate session id: ${resource.id}`)\n      ownSessionIds.add(sessionId)\n      if (!sessionIds.has(sessionId)) throw new Error(`Resource references an unknown session: ${sessionId}`)\n    }\n    if (resource.scope === 'session' && resource.sessionIds.length !== 1) {\n      throw new Error(`Session-scoped resource must reference exactly one session: ${resource.id}`)\n    }\n    if (resource.scope === 'global' && resource.sessionIds.length !== 0) {\n      throw new Error(`Global resource must not reference a session: ${resource.id}`)\n    }\n  }\n  const resourcesById = new Map(manifest.resources.map((resource) => [resource.id, resource]))\n  const sessionsById = new Map(manifest.sessions.map((session) => [session.id, session]))\n  for (const session of manifest.sessions) {\n    const ownResourceIds = new Set<string>()\n    for (const resourceId of session.resourceIds) {\n      if (ownResourceIds.has(resourceId)) throw new Error(`Session contains a duplicate resource id: ${session.id}`)\n      ownResourceIds.add(resourceId)\n      if (!resourceIds.has(resourceId)) throw new Error(`Session references an unknown resource: ${resourceId}`)\n      if (!resourcesById.get(resourceId)?.sessionIds.includes(session.id)) {\n        throw new Error(`Session/resource mapping is inconsistent: ${session.id}/${resourceId}`)\n      }\n    }\n  }\n  for (const resource of manifest.resources) {\n    for (const sessionId of resource.sessionIds) {\n      const session = sessionsById.get(sessionId)\n      if (!session?.resourceIds.includes(resource.id)) {\n        throw new Error(`Resource/session mapping is inconsistent: ${resource.id}/${sessionId}`)\n      }\n    }\n  }\n  if (\n    manifest.stats.sessionCount !== manifest.sessions.length ||\n    manifest.stats.resourceCount !== manifest.resources.length ||\n    manifest.stats.warningCount !== manifest.warnings.length\n  ) {","sourceCodeStart":114,"sourceCodeEnd":150,"githubUrl":"https://github.com/chatboxai/chatbox/blob/81571269addb6bafb589a920b2883f1e1e084fd1/src/renderer/packages/backup/types.ts#L114-L150","documentation":"Thrown when a session lists a resourceId that does not exist in manifest.resources. Every resource referenced by a session must be present, so dangling references are rejected.","triggerScenarios":"session.resourceIds contains an id not present among the manifest.resources ids.","commonSituations":"A resource was deleted but the session still references it; a partial export; an id mismatch (casing/trim).","solutions":["Add the missing resource entry.","Remove the dangling resourceId from the session.","Re-export sessions and resources together."],"exampleFix":"// before\n// session references a resource not in manifest.resources\n\n// after\nconst ids = new Set(manifest.resources.map((r) => r.id))\nfor (const s of manifest.sessions) {\n  s.resourceIds = s.resourceIds.filter((id) => ids.has(id))\n}","handlingStrategy":"try-catch","validationCode":"function findDanglingResourceRefs(manifest: BackupManifest): string[] {\n  const ids = new Set(manifest.resources.map((r) => r.id))\n  const dups = new Set<string>()\n  for (const s of manifest.sessions) for (const rid of s.resourceIds) if (!ids.has(rid)) dups.add(rid)\n  return [...dups]\n}","typeGuard":null,"tryCatchPattern":"try {\n  validateBackupManifestGraph(manifest)\n} catch (error) {\n  if (/references an unknown resource/.test((error as Error).message)) pruneDanglingResourceRefs(manifest)\n  throw error\n}","preventionTips":["Always export resources and their sessions together.","When deleting a resource, remove it from every session's resourceIds.","Normalize id casing/whitespace before packing the manifest."],"tags":["backup","manifest","validation","referential-integrity"],"backgroundTag":null,"analyzedSha":"81571269addb6bafb589a920b2883f1e1e084fd1","analyzedAt":"2026-08-12T21:51:44.981Z","schemaVersion":2},"datasetVersion":"2026-08-12T23:17:12.415Z"}