{"record":{"id":"c59d137e546c8759","repo":"chroma-core/chroma","slug":"transactional-read-token-offset-actualreadtoken","errorCode":null,"errorMessage":"transactional read token offset ${actualReadToken} is not a safe integer","messagePattern":"transactional read token offset (.+?) is not a safe integer","errorType":"exception","errorClass":"ChromaValueError","httpStatus":null,"severity":"error","filePath":"clients/new-js/packages/chromadb/src/collection.ts","lineNumber":1635,"sourceCode":"    const limit = request.limit ?? undefined;\n    if (!Number.isInteger(limit) || (limit as number) <= 0) {\n      throw new ChromaValueError(\n        \"transactional filter reads require a positive limit\",\n      );\n    }\n  }\n\n  private validateReadToken(\n    expectedReadToken: number | null,\n    actualReadToken: number | null | undefined,\n  ): void {\n    if (actualReadToken === null || actualReadToken === undefined) {\n      throw new ChromaValueError(\n        \"transactional get response did not include an OCC read token\",\n      );\n    }\n    if (!Number.isSafeInteger(actualReadToken) || actualReadToken < 0) {\n      throw new ChromaValueError(\n        `transactional read token offset ${actualReadToken} is not a safe integer`,\n      );\n    }\n    if (expectedReadToken !== null && expectedReadToken !== actualReadToken) {\n      throw new ChromaValueError(\n        \"transactional read token changed from log upper bound offset \" +\n          `${expectedReadToken} to ${actualReadToken}`,\n      );\n    }\n    if (this.readToken !== null && this.readToken !== actualReadToken) {\n      throw new ChromaValueError(\n        \"transactional read token changed from log upper bound offset \" +\n          `${this.readToken} to ${actualReadToken}`,\n      );\n    }\n  }\n\n  private bufferWrite(","sourceCodeStart":1617,"sourceCodeEnd":1653,"githubUrl":"https://github.com/chroma-core/chroma/blob/aecdd12c8a891610db8653630b066b32ceb678b5/clients/new-js/packages/chromadb/src/collection.ts#L1617-L1653","documentation":"Error \"transactional read token offset ${actualReadToken} is not a safe integer\" thrown in chroma-core/chroma.","triggerScenarios":"Thrown at clients/new-js/packages/chromadb/src/collection.ts:1635 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"aecdd12c8a891610db8653630b066b32ceb678b5","analyzedAt":"2026-08-16T21:53:27.228Z","schemaVersion":2},"datasetVersion":"2026-08-16T23:17:17.608Z"}