| | Heading 2 |

| | Bold | | | Italic | | | Lists |
/
| | Tables | | | Images | (base64) |",{"_31":8468,"_33":8469},[],{"_35":2509,"_37":8470,"_39":1595,"_41":8471,"_65":8472,"_67":8473,"_69":68},"cFjaz6f9",{},[],"Custom style mappings are supported.",{"_31":8475,"_33":8476},[],{"_35":2509,"_37":8477,"_39":1595,"_41":8478,"_65":8479,"_67":8484,"_69":68},"7EQeqDsA",{},[8480],{"_35":2722,"_2607":8481,"_2610":8482,"_41":8483,"_69":68},[146],[1257],{},"Repo: https://github.com/mwilliamson/mammoth.js",{"_31":8486,"_33":8647},[8487,8494,8506,8517,8528,8602,8613,8629,8640],{"_31":8488,"_33":8489},[],{"_35":2509,"_37":8490,"_39":1595,"_41":8491,"_65":8492,"_67":8493,"_69":68},"EwBA21D4",{},[],"Two possible conversion paths:",{"_31":8495,"_33":8496},[],{"_35":2509,"_37":8497,"_39":1595,"_41":8498,"_65":8499,"_67":8505,"_69":68},"qzzSc2hH",{},[8500],{"_35":2722,"_2607":8501,"_2610":8502,"_41":8504,"_69":68},[146],[8503],52,{},"Path A — mammoth → HTML → BlockNote's HTML-to-blocks",{"_31":8507,"_33":8508},[],{"_35":2509,"_37":8509,"_39":1595,"_41":8510,"_65":8511,"_67":8516,"_69":68},"BtrzXAtf",{},[8512],{"_35":2483,"_2607":8513,"_2610":8514,"_41":8515,"_69":68},[309,6141],[4688,4784],{},"BlockNote (used in packages/editor) already has tryParseHTMLToBlocks() which converts HTML into its internal block model. From there, the existing editor-to-HMBlockNode conversion can be reused. This path gets the richest output with minimal new code but couples the import to the editor package.",{"_31":8518,"_33":8519},[],{"_35":2509,"_37":8520,"_39":1595,"_41":8521,"_65":8522,"_67":8527,"_69":68},"8TOc2U_J",{},[8523],{"_35":2722,"_2607":8524,"_2610":8525,"_41":8526,"_69":68},[146],[5962],{},"Path B — mammoth → HTML → custom HMBlockNode[] mapper",{"_31":8529,"_33":8597},[8530,8541,8552,8563,8575,8586],{"_31":8531,"_33":8532},[],{"_35":2509,"_37":8533,"_39":1595,"_41":8534,"_65":8535,"_67":8540,"_69":68},"Vrvo1SKk",{},[8536],{"_35":2483,"_2607":8537,"_2610":8538,"_41":8539,"_69":68},[146,740,4855],[1257,1365,6141],{},"
–
→ {type: 'Heading', text, annotations} with heading-level nesting",{"_31":8542,"_33":8543},[],{"_35":2509,"_37":8544,"_39":1595,"_41":8545,"_65":8546,"_67":8551,"_69":68},"-KhtFEu7",{},[8547],{"_35":2483,"_2607":8548,"_2610":8549,"_41":8550,"_69":68},[146,577],[172,485],{},"
→ {type: 'Paragraph', text, annotations}",{"_31":8553,"_33":8554},[],{"_35":2509,"_37":8555,"_39":1595,"_41":8556,"_65":8557,"_67":8562,"_69":68},"-rwHuBn8",{},[8558],{"_35":2483,"_2607":8559,"_2610":8560,"_41":8561,"_69":68},[146,1421,1111,2724,8503,2612],[985,840,1335,5934,5266,7891],{},", , , → annotation spans with starts/ends character positions",{"_31":8564,"_33":8565},[],{"_35":2509,"_37":8566,"_39":1595,"_41":8567,"_65":8568,"_67":8574,"_69":68},"jyTNr64o",{},[8569],{"_35":2483,"_2607":8570,"_2610":8571,"_41":8573,"_69":68},[146,1306,2883],[1257,3821,8572],73,{},"
/ → Paragraph blocks with childrenType: 'Unordered' | 'Ordered'",{"_31":8576,"_33":8577},[],{"_35":2509,"_37":8578,"_39":1595,"_41":8579,"_65":8580,"_67":8585,"_69":68},"RQkm-6VK",{},[8581],{"_35":2483,"_2607":8582,"_2610":8583,"_41":8584,"_69":68},[146],[1306],{},"
→ Code block (current CLI behavior) or future Table block type",{"_31":8587,"_33":8588},[],{"_35":2509,"_37":8589,"_39":1595,"_41":8590,"_65":8591,"_67":8596,"_69":68},"KzwUDfb-",{},[8592],{"_35":2483,"_2607":8593,"_2610":8594,"_41":8595,"_69":68},[146,5835],[740,4785],{}," → extract base64 data, upload via blob storage, create {type: 'Image', link: ipfsUrl}",{"_35":2509,"_37":8598,"_39":1595,"_41":8599,"_65":8600,"_67":8601,"_69":68},"tiETJwxC",{"_2582":2583},[],"Write a standalone HTML-to-HMBlockNode converter. Walk the DOM tree and map:",{"_31":8603,"_33":8604},[],{"_35":2509,"_37":8605,"_39":1595,"_41":8606,"_65":8607,"_67":8612,"_69":68},"bB1pl5yx",{},[8608],{"_35":2483,"_2607":8609,"_2610":8610,"_41":8611,"_69":68},[1421,6356,6045],[4337,177,6201],{},"Then call flattenToOperations(blocks) and feed into the standard document create or document update flow.",{"_31":8614,"_33":8615},[],{"_35":2509,"_37":8616,"_39":1595,"_41":8617,"_65":8618,"_67":8628,"_69":68},"HBajGde8",{},[8619,8623],{"_35":2722,"_2607":8620,"_2610":8621,"_41":8622,"_69":68},[146],[2357],{},{"_35":2483,"_2607":8624,"_2610":8626,"_41":8627,"_69":68},[4746,8625],146,[4744,5286],{},"Image handling note: mammoth extracts images as base64 tags. These need to be uploaded to blob storage (UnixFS chunking, ~256KB chunks, via storeBlobs with 4MB message limit) and replaced with IPFS CID links before creating the Image blocks.",{"_31":8630,"_33":8631},[],{"_35":2509,"_37":8632,"_39":1595,"_41":8633,"_65":8634,"_67":8639,"_69":68},"4AtwCnQ7",{},[8635],{"_35":2722,"_2607":8636,"_2610":8637,"_41":8638,"_69":68},[146],[5454],{},"CLI usage would look like:",{"_31":8641,"_33":8642},[],{"_35":2483,"_37":8643,"_39":1595,"_41":8644,"_65":8645,"_67":8646,"_69":68},"gYzHOHwG",{"_2486":7664},[],"seed-cli document create z6Mk... --title \"Imported Doc\" --docx report.docx --key main\nseed-cli document update hm://z6Mk.../doc --replace-docx updated.docx --key main\n",{"_35":2580,"_37":8648,"_39":1595,"_41":8649,"_65":8650,"_67":8651,"_69":68},"ZMq4ty6n",{"_2582":239},[],"SDK Integration",{"_31":8653,"_33":8694},[8654,8669,8676,8687],{"_31":8655,"_33":8656},[],{"_35":2509,"_37":8657,"_39":1595,"_41":8658,"_65":8659,"_67":8668,"_69":68},"YxSauU8b",{},[8660,8664],{"_35":2722,"_2607":8661,"_2610":8662,"_41":8663,"_69":68},[146],[172],{},{"_35":2483,"_2607":8665,"_2610":8666,"_41":8667,"_69":68},[740],[4715],{},"npm: officeparser",{"_31":8670,"_33":8671},[],{"_35":2509,"_37":8672,"_39":1595,"_41":8673,"_65":8674,"_67":8675,"_69":68},"zpLJmVBd",{},[],"Produces a hierarchical AST (paragraphs, headings, tables, lists, bold/italic)",{"_31":8677,"_33":8678},[],{"_35":2509,"_37":8679,"_39":1595,"_41":8680,"_65":8681,"_67":8686,"_69":68},"Oiq4fdJ5",{},[8682],{"_35":2483,"_2607":8683,"_2610":8684,"_41":8685,"_69":68},[4700,2357,5934,6479,4810],[4808,3566,4701,4337,4856],{},"Also handles .pptx, .xlsx, .odt, .pdf, .rtf",{"_31":8688,"_33":8689},[],{"_35":2509,"_37":8690,"_39":1595,"_41":8691,"_65":8692,"_67":8693,"_69":68},"7DRoPKEz",{},[],"Newer and less battle-tested than mammoth",{"_35":2580,"_37":8695,"_39":1595,"_41":8696,"_65":8697,"_67":8702,"_69":68},"MSjBS70I",{"_2582":2583},[8698],{"_35":2483,"_2607":8699,"_2610":8700,"_41":8701,"_69":68},[4700],[3566],{},"Alternative: officeparser",{"_35":2580,"_37":8704,"_39":1595,"_41":8705,"_65":8706,"_67":8711,"_69":68},"nbFZff6k",{"_2582":2583},[8707],{"_35":2483,"_2607":8708,"_2610":8709,"_41":8710,"_69":68},[1306],[840],{},"DOCX — mammoth",{"_31":8713,"_33":8979},[8714,8783,8863],{"_31":8715,"_33":8774},[8716,8731,8742,8753,8760,8767],{"_31":8717,"_33":8718},[],{"_35":2509,"_37":8719,"_39":1595,"_41":8720,"_65":8721,"_67":8730,"_69":68},"KOHxuxzw",{},[8722,8726],{"_35":2722,"_2607":8723,"_2610":8724,"_41":8725,"_69":68},[146],[172],{},{"_35":2483,"_2607":8727,"_2610":8728,"_41":8729,"_69":68},[740],[2357],{},"npm: read-excel-file",{"_31":8732,"_33":8733},[],{"_35":2509,"_37":8734,"_39":1595,"_41":8735,"_65":8736,"_67":8741,"_69":68},"2I_4V6an",{},[8737],{"_35":2722,"_2607":8738,"_2610":8739,"_41":8740,"_69":68},[146],[3821],{},"Bundle size: ~37 KB gzipped",{"_31":8743,"_33":8744},[],{"_35":2509,"_37":8745,"_39":1595,"_41":8746,"_65":8747,"_67":8752,"_69":68},"1eMdJ7OR",{},[8748],{"_35":2722,"_2607":8749,"_2610":8750,"_41":8751,"_69":68},[146],[1892],{},"Browser support: Yes (browser-first design)",{"_31":8754,"_33":8755},[],{"_35":2509,"_37":8756,"_39":1595,"_41":8757,"_65":8758,"_67":8759,"_69":68},"JLk1k41U",{},[],"Returns rows as arrays of cells (string/number/Date/boolean)",{"_31":8761,"_33":8762},[],{"_35":2509,"_37":8763,"_39":1595,"_41":8764,"_65":8765,"_67":8766,"_69":68},"ueU5YjcO",{},[],"Supports schema-based parsing for typed JSON objects",{"_31":8768,"_33":8769},[],{"_35":2509,"_37":8770,"_39":1595,"_41":8771,"_65":8772,"_67":8773,"_69":68},"RCxz1xTT",{},[],"Does not handle formulas",{"_35":2580,"_37":8775,"_39":1595,"_41":8776,"_65":8777,"_67":8782,"_69":68},"aQT-hPE1",{"_2582":2583},[8778],{"_35":2483,"_2607":8779,"_2610":8780,"_41":8781,"_69":68},[1421],[3566],{},"Option A: read-excel-file (lightweight, recommended)",{"_31":8784,"_33":8854},[8785,8800,8811,8821,8828,8843],{"_31":8786,"_33":8787},[],{"_35":2509,"_37":8788,"_39":1595,"_41":8789,"_65":8790,"_67":8799,"_69":68},"p3srzukZ",{},[8791,8795],{"_35":2722,"_2607":8792,"_2610":8793,"_41":8794,"_69":68},[146],[172],{},{"_35":2483,"_2607":8796,"_2610":8797,"_41":8798,"_69":68},[740],[1365],{},"npm: xlsx",{"_31":8801,"_33":8802},[],{"_35":2509,"_37":8803,"_39":1595,"_41":8804,"_65":8805,"_67":8810,"_69":68},"36S2O5v6",{},[8806],{"_35":2722,"_2607":8807,"_2610":8808,"_41":8809,"_69":68},[146],[3821],{},"Bundle size: ~300–500 KB gzipped",{"_31":8812,"_33":8813},[],{"_35":2509,"_37":8814,"_39":1595,"_41":8815,"_65":8816,"_67":8426,"_69":68},"E7SdQ8Sf",{},[8817],{"_35":2722,"_2607":8818,"_2610":8819,"_41":8820,"_69":68},[146],[1892],{},{"_31":8822,"_33":8823},[],{"_35":2509,"_37":8824,"_39":1595,"_41":8825,"_65":8826,"_67":8827,"_69":68},"zFUHVkA-",{},[],"Handles merged cells, formulas, number formatting",{"_31":8829,"_33":8830},[],{"_35":2509,"_37":8831,"_39":1595,"_41":8832,"_65":8833,"_67":8842,"_69":68},"LFXxb1GH",{},[8834,8838],{"_35":2722,"_2607":8835,"_2610":8836,"_41":8837,"_69":68},[146],[577],{},{"_35":2483,"_2607":8839,"_2610":8840,"_41":8841,"_69":68},[5147],[7835],{},"Caveat: npm version stuck at 0.18.5; newer versions distributed via cdn.sheetjs.com",{"_31":8844,"_33":8845},[],{"_35":2509,"_37":8846,"_39":1595,"_41":8847,"_65":8848,"_67":8853,"_69":68},"5e0kKEJd",{},[8849],{"_35":2722,"_2607":8850,"_2610":8851,"_41":8852,"_69":68},[146],[1257],{},"Docs: https://docs.sheetjs.com/",{"_35":2580,"_37":8855,"_39":1595,"_41":8856,"_65":8857,"_67":8862,"_69":68},"K1whkQVo",{"_2582":2583},[8858],{"_35":2483,"_2607":8859,"_2610":8860,"_41":8861,"_69":68},[1421],[840],{},"Option B: xlsx / SheetJS (full-featured)",{"_31":8864,"_33":8975},[8865,8872,8883,8890,8928,8943,8953,8960],{"_31":8866,"_33":8867},[],{"_35":2509,"_37":8868,"_39":1595,"_41":8869,"_65":8870,"_67":8871,"_69":68},"y1wNA0Jr",{},[],"Spreadsheets don't map to the existing markdown parser at all — they need a dedicated converter.",{"_31":8873,"_33":8874},[],{"_35":2509,"_37":8875,"_39":1595,"_41":8876,"_65":8877,"_67":8882,"_69":68},"SN7IgHmW",{},[8878],{"_35":2722,"_2607":8879,"_2610":8880,"_41":8881,"_69":68},[146],[1111],{},"Conversion flow:",{"_31":8884,"_33":8885},[],{"_35":2483,"_37":8886,"_39":1595,"_41":8887,"_65":8888,"_67":8889,"_69":68},"iVA2cskX",{"_2486":68},[],".xlsx → read-excel-file/SheetJS → rows[][] per sheet\n → for each sheet:\n Heading block (sheet name)\n → Table-like structure as child blocks\n → flattenToOperations(blocks)\n → standard signing/publish flow\n",{"_31":8891,"_33":8919},[8892,8908],{"_31":8893,"_33":8894},[],{"_35":2509,"_37":8895,"_39":1595,"_41":8896,"_65":8897,"_67":8907,"_69":68},"krqr2J2w",{},[8898,8902],{"_35":2722,"_2607":8899,"_2610":8900,"_41":8901,"_69":68},[146],[1892],{},{"_35":2483,"_2607":8903,"_2610":8904,"_41":8906,"_69":68},[5513],[8905],169,{},"As a Code block (simplest, matches current CLI behavior for tables): Render the spreadsheet as a markdown/CSV table string inside a {type: 'code-block', text: csvString} block. The CLI already renders markdown tables as Code blocks.",{"_31":8909,"_33":8910},[],{"_35":2509,"_37":8911,"_39":1595,"_41":8912,"_65":8913,"_67":8918,"_69":68},"NnoCuLNR",{},[8914],{"_35":2722,"_2607":8915,"_2610":8916,"_41":8917,"_69":68},[146],[5454],{},"As nested Paragraph blocks (richer but verbose): Each row becomes a Paragraph block, cells separated by formatting. Poor UX for large sheets.",{"_35":2509,"_37":8920,"_39":1595,"_41":8921,"_65":8922,"_67":8927,"_69":68},"ayBcg64i",{"_2582":2878},[8923],{"_35":2722,"_2607":8924,"_2610":8925,"_41":8926,"_69":68},[146],[1335],{},"Block mapping options:",{"_31":8929,"_33":8930},[],{"_35":2509,"_37":8931,"_39":1595,"_41":8932,"_65":8933,"_67":8942,"_69":68},"LNnpW0HO",{},[8934,8938],{"_35":2722,"_2607":8935,"_2610":8936,"_41":8937,"_69":68},[146],[4797],{},{"_35":2483,"_2607":8939,"_2610":8940,"_41":8941,"_69":68},[5268],[6421],{},"Multi-sheet handling: Each worksheet becomes a Heading block with the sheet's content as children. The flattenToOperations() function already handles nested parent-child block trees via MoveBlocks operations.",{"_31":8944,"_33":8945},[],{"_35":2509,"_37":8946,"_39":1595,"_41":8947,"_65":8948,"_67":8639,"_69":68},"pSPCPxSr",{},[8949],{"_35":2722,"_2607":8950,"_2610":8951,"_41":8952,"_69":68},[146],[5454],{},{"_31":8954,"_33":8955},[],{"_35":2483,"_37":8956,"_39":1595,"_41":8957,"_65":8958,"_67":8959,"_69":68},"Zi9oulog",{"_2486":7664},[],"seed-cli document create z6Mk... --title \"Q4 Report\" --xlsx data.xlsx --key main\n# Each sheet becomes a section under the document\n",{"_31":8961,"_33":8962},[],{"_35":2509,"_37":8963,"_39":1595,"_41":8964,"_65":8965,"_67":8974,"_69":68},"dlulKxYs",{},[8966,8970],{"_35":2722,"_2607":8967,"_2610":8968,"_41":8969,"_69":68},[146],[3566],{},{"_35":2483,"_2607":8971,"_2610":8972,"_41":8973,"_69":68},[2727],[5284],{},"Practical recommendation: Start with Option A (read-excel-file) rendering sheets as Code blocks containing markdown tables. This requires zero schema changes and works with the existing pipeline immediately.",{"_35":2580,"_37":8976,"_39":1595,"_41":8977,"_65":8978,"_67":8651,"_69":68},"HTZMLAM7",{"_2582":239},[],{"_35":2580,"_37":8980,"_39":1595,"_41":8981,"_65":8982,"_67":8987,"_69":68},"R8itN9xh",{"_2582":239},[8983],{"_35":2483,"_2607":8984,"_2610":8985,"_41":8986,"_69":68},[1306,5454],[1335,6232],{},"XLSX — read-excel-file or xlsx (SheetJS)",{"_31":8989,"_33":9364},[8990,9005,9016,9027,9038,9098,9109,9283],{"_31":8991,"_33":8992},[],{"_35":2509,"_37":8993,"_39":1595,"_41":8994,"_65":8995,"_67":9004,"_69":68},"LLS7gZvG",{},[8996,9000],{"_35":2722,"_2607":8997,"_2610":8998,"_41":8999,"_69":68},[146],[172],{},{"_35":2483,"_2607":9001,"_2610":9002,"_41":9003,"_69":68},[740],[1892],{},"npm: pdfjs-dist",{"_31":9006,"_33":9007},[],{"_35":2509,"_37":9008,"_39":1595,"_41":9009,"_65":9010,"_67":9015,"_69":68},"FaLFuNir",{},[9011],{"_35":2722,"_2607":9012,"_2610":9013,"_41":9014,"_69":68},[146],[3821],{},"Bundle size: ~400–800 KB gzipped (heavy)",{"_31":9017,"_33":9018},[],{"_35":2509,"_37":9019,"_39":1595,"_41":9020,"_65":9021,"_67":9026,"_69":68},"68eh3J-x",{},[9022],{"_35":2722,"_2607":9023,"_2610":9024,"_41":9025,"_69":68},[146],[1892],{},"Browser support: Yes (this is Firefox's PDF engine)",{"_31":9028,"_33":9029},[],{"_35":2509,"_37":9030,"_39":1595,"_41":9031,"_65":9032,"_67":9037,"_69":68},"MG_NgQkA",{},[9033],{"_35":2722,"_2607":9034,"_2610":9035,"_41":9036,"_69":68},[146],[4808],{},"Structural quality: Low — PDFs have no semantic structure",{"_31":9039,"_33":9084},[9040,9051,9062,9073],{"_31":9041,"_33":9042},[],{"_35":2509,"_37":9043,"_39":1595,"_41":9044,"_65":9045,"_67":9050,"_69":68},"XVZ2rPFc",{},[9046],{"_35":2722,"_2607":9047,"_2610":9048,"_41":9049,"_69":68},[146],[985],{},"Headings: larger font size",{"_31":9052,"_33":9053},[],{"_35":2509,"_37":9054,"_39":1595,"_41":9055,"_65":9056,"_67":9061,"_69":68},"NQHuSbG6",{},[9057],{"_35":2722,"_2607":9058,"_2610":9059,"_41":9060,"_69":68},[146],[1421],{},"Paragraphs: spatial proximity grouping",{"_31":9063,"_33":9064},[],{"_35":2509,"_37":9065,"_39":1595,"_41":9066,"_65":9067,"_67":9072,"_69":68},"L7_Gu8G2",{},[9068],{"_35":2722,"_2607":9069,"_2610":9070,"_41":9071,"_69":68},[146],[577],{},"Tables: grid-aligned text detection",{"_31":9074,"_33":9075},[],{"_35":2509,"_37":9076,"_39":1595,"_41":9077,"_65":9078,"_67":9083,"_69":68},"yxztKwqq",{},[9079],{"_35":2722,"_2607":9080,"_2610":9081,"_41":9082,"_69":68},[146],[577],{},"Images: separate rendering pass",{"_35":2509,"_37":9085,"_39":1595,"_41":9086,"_65":9087,"_67":9097,"_69":68},"SnJ20UA6",{"_2582":2583},[9088,9092],{"_35":2483,"_2607":9089,"_2610":9090,"_41":9091,"_69":68},[4747],[5483],{},{"_35":2722,"_2607":9093,"_2610":9094,"_41":9096,"_69":68},[5739],[9095],126,{},"Extracts text items with position coordinates (x, y), font info, and text content per page via page.getTextContent(). Does not natively give you headings, paragraphs, or tables — you must reconstruct structure from:",{"_31":9099,"_33":9100},[],{"_35":2509,"_37":9101,"_39":1595,"_41":9102,"_65":9103,"_67":9108,"_69":68},"mXOnmfdz",{},[9104],{"_35":2722,"_2607":9105,"_2610":9106,"_41":9107,"_69":68},[146],[1257],{},"Repo: https://github.com/mozilla/pdf.js",{"_31":9110,"_33":9279},[9111,9122,9132,9139,9183,9229,9246,9256,9263],{"_31":9112,"_33":9113},[],{"_35":2509,"_37":9114,"_39":1595,"_41":9115,"_65":9116,"_67":9121,"_69":68},"s_leYnDr",{},[9117],{"_35":2483,"_2607":9118,"_2610":9119,"_41":9120,"_69":68},[4688,7540],[485,7572],{},"PDF is the hardest format because pdfjs-dist returns positioned text items, not semantic blocks. A heuristic layer is needed between the parser and HMBlockNode[].",{"_31":9123,"_33":9124},[],{"_35":2509,"_37":9125,"_39":1595,"_41":9126,"_65":9127,"_67":8882,"_69":68},"tj9YtoEV",{},[9128],{"_35":2722,"_2607":9129,"_2610":9130,"_41":9131,"_69":68},[146],[1111],{},{"_31":9133,"_33":9134},[],{"_35":2483,"_37":9135,"_39":1595,"_41":9136,"_65":9137,"_67":9138,"_69":68},"IEldMsw4",{"_2486":68},[],".pdf → pdfjs getTextContent() → TextItem[] with {str, transform, fontName, ...}\n → heuristic grouping:\n 1. Group text items into lines (same Y coordinate within tolerance)\n 2. Group lines into paragraphs (vertical gap < threshold)\n 3. Detect headings (font size > body font size)\n 4. Detect lists (lines starting with \"•\", \"-\", \"1.\")\n → HMBlockNode[] (mostly Paragraph + Heading blocks)\n → flattenToOperations(blocks)\n → standard signing/publish flow\n",{"_31":9140,"_33":9174},[9141,9152,9163],{"_31":9142,"_33":9143},[],{"_35":2509,"_37":9144,"_39":1595,"_41":9145,"_65":9146,"_67":9151,"_69":68},"4Q6C9sDd",{},[9147],{"_35":2483,"_2607":9148,"_2610":9149,"_41":9150,"_69":68},[4808],[5986],{},"Large-font text → {type: 'Heading', text} with annotations",{"_31":9153,"_33":9154},[],{"_35":2509,"_37":9155,"_39":1595,"_41":9156,"_65":9157,"_67":9162,"_69":68},"OKUPeTd4",{},[9158],{"_35":2483,"_2607":9159,"_2610":9160,"_41":9161,"_69":68},[309],[485],{},"Body text groups → {type: 'Paragraph', text} with bold/italic from font metadata",{"_31":9164,"_33":9165},[],{"_35":2509,"_37":9166,"_39":1595,"_41":9167,"_65":9168,"_67":9173,"_69":68},"_Cw0tqXg",{},[9169],{"_35":2483,"_2607":9170,"_2610":9171,"_41":9172,"_69":68},[711],[5267],{},"Bullet/numbered patterns → Paragraph with childrenType: 'Unordered' | 'Ordered'",{"_35":2509,"_37":9175,"_39":1595,"_41":9176,"_65":9177,"_67":9182,"_69":68},"eVSOcyTS",{"_2582":2583},[9178],{"_35":2722,"_2607":9179,"_2610":9180,"_41":9181,"_69":68},[146],[6479],{},"What maps cleanly to HMBlockNode:",{"_31":9184,"_33":9220},[9185,9192,9199,9206,9213],{"_31":9186,"_33":9187},[],{"_35":2509,"_37":9188,"_39":1595,"_41":9189,"_65":9190,"_67":9191,"_69":68},"9oLUhfrH",{},[],"Multi-column layouts (text items interleave columns)",{"_31":9193,"_33":9194},[],{"_35":2509,"_37":9195,"_39":1595,"_41":9196,"_65":9197,"_67":9198,"_69":68},"af6BR6S-",{},[],"Tables (must detect grid alignment — complex heuristic)",{"_31":9200,"_33":9201},[],{"_35":2509,"_37":9202,"_39":1595,"_41":9203,"_65":9204,"_67":9205,"_69":68},"ziEV3kFm",{},[],"Images (requires separate canvas rendering per page, then blob upload)",{"_31":9207,"_33":9208},[],{"_35":2509,"_37":9209,"_39":1595,"_41":9210,"_65":9211,"_67":9212,"_69":68},"CAFJJHhr",{},[],"Headers/footers (appear as regular text items)",{"_31":9214,"_33":9215},[],{"_35":2509,"_37":9216,"_39":1595,"_41":9217,"_65":9218,"_67":9219,"_69":68},"W2nj3XK3",{},[],"Mathematical formulas (not extractable as LaTeX)",{"_35":2509,"_37":9221,"_39":1595,"_41":9222,"_65":9223,"_67":9228,"_69":68},"L2iFqA5x",{"_2582":2583},[9224],{"_35":2722,"_2607":9225,"_2610":9226,"_41":9227,"_69":68},[146],[1335],{},"What doesn't map well:",{"_31":9230,"_33":9231},[],{"_35":2509,"_37":9232,"_39":1595,"_41":9233,"_65":9234,"_67":9245,"_69":68},"Od6pxQwu",{},[9235,9239],{"_35":2722,"_2607":9236,"_2610":9237,"_41":9238,"_69":68},[146,2883,4781],[4700,5146,2728],{},{"_35":2483,"_2607":9240,"_2610":9242,"_41":9244,"_69":68},[4700,5146,9241,6012],255,[2883,4781,9243,7972],261,{},"The existing parseInlineFormatting() in markdown.ts builds annotation spans from character positions. The same pattern applies here — as you concatenate text items into a paragraph string, track font changes to create Bold/Italic annotations with correct starts/ends offsets.",{"_31":9247,"_33":9248},[],{"_35":2509,"_37":9249,"_39":1595,"_41":9250,"_65":9251,"_67":8639,"_69":68},"0A2dunHA",{},[9252],{"_35":2722,"_2607":9253,"_2610":9254,"_41":9255,"_69":68},[146],[5454],{},{"_31":9257,"_33":9258},[],{"_35":2483,"_37":9259,"_39":1595,"_41":9260,"_65":9261,"_67":9262,"_69":68},"vvVqhIUG",{"_2486":7664},[],"seed-cli document create z6Mk... --title \"Research Paper\" --pdf paper.pdf --key main\n# Best-effort text extraction with heuristic heading detection\n",{"_31":9264,"_33":9265},[],{"_35":2509,"_37":9266,"_39":1595,"_41":9267,"_65":9268,"_67":9278,"_69":68},"gMSpplYq",{},[9269,9273],{"_35":2722,"_2607":9270,"_2610":9271,"_41":9272,"_69":68},[146],[3566],{},{"_35":2483,"_2607":9274,"_2610":9275,"_41":9277,"_69":68},[5461],[9276],118,{},"Practical recommendation: Offer this as a \"basic text import\" rather than promising structural fidelity. The --verbose flag could show warnings about low-confidence heading detection or skipped elements.",{"_35":2580,"_37":9280,"_39":1595,"_41":9281,"_65":9282,"_67":8651,"_69":68},"XjdD5vo5",{"_2582":239},[],{"_31":9284,"_33":9355},[9285,9300,9311,9318,9329,9340],{"_31":9286,"_33":9287},[],{"_35":2509,"_37":9288,"_39":1595,"_41":9289,"_65":9290,"_67":9299,"_69":68},"2qOj0HIx",{},[9291,9295],{"_35":2722,"_2607":9292,"_2610":9293,"_41":9294,"_69":68},[146],[172],{},{"_35":2483,"_2607":9296,"_2610":9297,"_41":9298,"_69":68},[740],[1421],{},"npm: unpdf",{"_31":9301,"_33":9302},[],{"_35":2509,"_37":9303,"_39":1595,"_41":9304,"_65":9305,"_67":9310,"_69":68},"l5hxcjw_",{},[9306],{"_35":2722,"_2607":9307,"_2610":9308,"_41":9309,"_69":68},[146],[3821],{},"Bundle size: ~390 KB gzipped",{"_31":9312,"_33":9313},[],{"_35":2509,"_37":9314,"_39":1595,"_41":9315,"_65":9316,"_67":9317,"_69":68},"4s6cxeYz",{},[],"Cleaner async/await API wrapper around pdf.js",{"_31":9319,"_33":9320},[],{"_35":2509,"_37":9321,"_39":1595,"_41":9322,"_65":9323,"_67":9328,"_69":68},"yhdCY_1w",{},[9324],{"_35":2483,"_2607":9325,"_2610":9326,"_41":9327,"_69":68},[1365,1335,2883],[2357,4688,4856],{},"Methods: extractText, extractLinks, getMeta",{"_31":9330,"_33":9331},[],{"_35":2509,"_37":9332,"_39":1595,"_41":9333,"_65":9334,"_67":9339,"_69":68},"4ee19moK",{},[9335],{"_35":2722,"_2607":9336,"_2610":9337,"_41":9338,"_69":68},[146],[1257],{},"Repo: https://github.com/unjs/unpdf",{"_31":9341,"_33":9342},[],{"_35":2509,"_37":9343,"_39":1595,"_41":9344,"_65":9345,"_67":9354,"_69":68},"2atV15AH",{},[9346,9350],{"_35":2722,"_2607":9347,"_2610":9348,"_41":9349,"_69":68},[146],[985],{},{"_35":2483,"_2607":9351,"_2610":9352,"_41":9353,"_69":68},[1421],[4797],{},"SDK note: extractText returns plain string per page — simpler but loses all font/position metadata needed for heading detection. Only viable for plain-text-only import.",{"_35":2580,"_37":9356,"_39":1595,"_41":9357,"_65":9358,"_67":9363,"_69":68},"hMV_pvpI",{"_2582":2583},[9359],{"_35":2483,"_2607":9360,"_2610":9361,"_41":9362,"_69":68},[4700],[4808],{},"Alternative: unpdf",{"_35":2580,"_37":9365,"_39":1595,"_41":9366,"_65":9367,"_67":9372,"_69":68},"rFiepJWU",{"_2582":2583},[9368],{"_35":2483,"_2607":9369,"_2610":9370,"_41":9371,"_69":68},[577],[1111],{},"PDF — pdfjs-dist",{"_31":9374,"_33":9395},[9375,9388],{"_31":9376,"_33":9377},[],{"_35":2509,"_37":9378,"_39":1595,"_41":9379,"_65":9380,"_67":9387,"_69":68},"bG7LIUOh",{},[9381],{"_35":2483,"_2607":9382,"_2610":9384,"_41":9386,"_69":68},[4744,5965,5470,9383,5330],129,[8572,5461,9095,8458,9385],166,{},"All three formats converge at the same point: once you have HMBlockNode[], the existing flattenToOperations() → createChange() → createVersionRef() → client.publish() pipeline handles the rest unchanged.",{"_31":9389,"_33":9390},[],{"_35":2509,"_37":9391,"_39":1595,"_41":9392,"_65":9393,"_67":9394,"_69":68},"qpD_4ZEr",{},[],"DOCX is the clear quick win — mammoth's HTML output maps almost 1:1 to the block model. XLSX is straightforward but limited to table-like rendering. PDF requires the most custom heuristic code for the least structural fidelity.",{"_35":2580,"_37":9396,"_39":1595,"_41":9397,"_65":9398,"_67":9399,"_69":68},"xgcNG8zD",{"_2582":239},[],"Summary",[76],"/tech-talks/file-import-libraries-research",{"_86":1615,"_88":1616},{},{"_92":1595,"_96":1613},{"_37":1592,"_104":53,"_54":9406,"_70":1595,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,1594],1778632074339,[158,1592,1595,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/file-import-libraries-research\",\"bafy2bzacebacooy7bmu7675fwf4ww5coyrc3ii6wa4v43w675yv6mqu3ft76a\",true]",{"_119":9411,"_156":9451,"_159":9452},{"_121":9412,"_141":44,"_142":9450,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":9413,"_37":9448},{"_28":9414,"_70":1651,"_71":53,"_72":9443,"_54":9444,"_80":1658,"_82":1658,"_84":9445,"_90":9446,"_92":1651,"_94":9447,"_98":99},[9415,9422,9429,9436],{"_31":9416,"_33":9417},[],{"_35":2509,"_37":9418,"_39":1651,"_41":9419,"_65":9420,"_67":9421,"_69":68},"q-IJLqU4",{},[],"The notification server needs to send a notifications list to the client, to make sure the user sees all of their notifications.",{"_31":9423,"_33":9424},[],{"_35":2509,"_37":9425,"_39":1651,"_41":9426,"_65":9427,"_67":9428,"_69":68},"QHHIaoLo",{},[],"This is relevant because the client may not have all the same data available as the notification server has. The notification server is expected to see \"everything\" because it sends out the emails, etc.",{"_31":9430,"_33":9431},[],{"_35":2509,"_37":9432,"_39":1651,"_41":9433,"_65":9434,"_67":9435,"_69":68},"FqiyrzVM",{},[],"But, the notification list is ever-increasing. So the server should either support pagination (and the client will fetch things it already has - only stopping when the user stops scrolling down), or we should develop some range-based-set-reconciliation.",{"_31":9437,"_33":9438},[],{"_35":2509,"_37":9439,"_39":1651,"_41":9440,"_65":9441,"_67":9442,"_69":68},"v16CG8Cx",{},[],"For content that is p2p synced, the client can still generate its own notifications, without connection to the notif server. So we will need a consistent mechanism to generate a notification ID.",[74],"/tech-talks/notif-rbsr",{"_86":1671},{},{"_92":1651,"_96":1669},{"_37":1648,"_104":53,"_54":9449,"_70":1651,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,1650],1778632074353,[158,1648,1651,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/notif-rbsr\",\"bafy2bzaceacf3iqxz5bmf5fd3xzr4fbryu3ug22epuawe5bg6qozrurykspok\",true]",{"_119":9454,"_156":9548,"_159":9549},{"_121":9455,"_141":44,"_142":9547,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":9456,"_37":9545},{"_28":9457,"_70":1677,"_71":53,"_72":9540,"_54":9541,"_80":1684,"_82":1684,"_84":9542,"_90":9543,"_92":1677,"_94":9544,"_98":99},[9458,9465,9471,9485,9499,9513,9527],{"_31":9459,"_33":9460},[],{"_35":2509,"_37":9461,"_39":1677,"_41":9462,"_65":9463,"_67":9464,"_69":68},"jPM6LH6G",{},[],"This doc aims to explain the technical features behind the various Join/Subscribe/Follow/Notify workflows",{"_31":9466,"_33":9467},[],{"_35":2509,"_37":9468,"_39":1677,"_41":9469,"_65":9470,"_67":68,"_69":68},"nEN2zYp0",{},[],{"_31":9472,"_33":9480},[9473],{"_31":9474,"_33":9475},[],{"_35":2509,"_37":9476,"_39":1677,"_41":9477,"_65":9478,"_67":9479,"_69":68},"mGud6gjP",{},[],"Our original \"Subscribe\" in the desktop app which allows for background sync and archival of a doc or site",{"_35":2580,"_37":9481,"_39":1677,"_41":9482,"_65":9483,"_67":9484,"_69":68},"WtbZysAz",{"_2582":239},[],"Subscription Syncing",{"_31":9486,"_33":9494},[9487],{"_31":9488,"_33":9489},[],{"_35":2509,"_37":9490,"_39":1677,"_41":9491,"_65":9492,"_67":9493,"_69":68},"n4Sqp3gI",{},[],"Our existing email notifications",{"_35":2580,"_37":9495,"_39":1677,"_41":9496,"_65":9497,"_67":9498,"_69":68},"O0Mj_ZgI",{"_2582":239},[],"Anonymous Email Notifications",{"_31":9500,"_33":9508},[9501],{"_31":9502,"_33":9503},[],{"_35":2509,"_37":9504,"_39":1677,"_41":9505,"_65":9506,"_67":9507,"_69":68},"oJbZA9J3",{},[],"Used to give easy access to something in the desktop app. Not strictly related to follow/join/subscribe, but might be related or useful",{"_35":2580,"_37":9509,"_39":1677,"_41":9510,"_65":9511,"_67":9512,"_69":68},"SzzCy-mv",{"_2582":239},[],"Favorite/Bookmark",{"_31":9514,"_33":9522},[9515],{"_31":9516,"_33":9517},[],{"_35":2509,"_37":9518,"_39":1677,"_41":9519,"_65":9520,"_67":9521,"_69":68},"73AWQ7zY",{},[],"The upcoming notification workflow where an account has authenticated interaction with the notification server. Currently used for mentions and replies but will soon be used for email notifications",{"_35":2580,"_37":9523,"_39":1677,"_41":9524,"_65":9525,"_67":9526,"_69":68},"OyQpjihL",{"_2582":239},[],"Account/Synced Notification",{"_31":9528,"_33":9536},[9529],{"_31":9530,"_33":9531},[],{"_35":2509,"_37":9532,"_39":1677,"_41":9533,"_65":9534,"_67":9535,"_69":68},"k1JZhGk_",{},[],"A signed contact blob where one account publicly acknowledges another",{"_35":2580,"_37":9537,"_39":1677,"_41":9538,"_65":9539,"_67":4959,"_69":68},"WSBI89f0",{"_2582":239},[],[74],"/tech-talks/joinsubscribefollownotify",{"_86":1693},{},{"_92":1677,"_96":1691},{"_37":1674,"_104":53,"_54":9546,"_70":1677,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,1676],1778632074350,[158,1674,1677,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/joinsubscribefollownotify\",\"bafy2bzacec3boggkxtxylhtxwaq6roa37kejjcvls6lmty44w2h3feac4f25g\",true]",{"_119":9551,"_156":9708,"_159":9709},{"_121":9552,"_141":44,"_142":9707,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":9553,"_37":9705},{"_28":9554,"_70":1823,"_71":53,"_72":9700,"_54":9701,"_80":1830,"_82":1830,"_84":9702,"_90":9703,"_92":1823,"_94":9704,"_98":99},[9555,9566,9577,9618,9659],{"_31":9556,"_33":9557},[],{"_35":2509,"_37":9558,"_39":1823,"_41":9559,"_65":9560,"_67":9565,"_69":68},"L-K4B5E5",{},[9561],{"_35":2483,"_2607":9562,"_2610":9563,"_41":9564,"_69":68},[2357],[6232],{},"Currently we have a ?feed=true route in our web app.",{"_31":9567,"_33":9568},[],{"_35":2509,"_37":9569,"_39":1823,"_41":9570,"_65":9571,"_67":9576,"_69":68},"C9LXtCX-",{},[9572],{"_35":2483,"_2607":9573,"_2610":9574,"_41":9575,"_69":68},[4712],[5998],{},"This is inconsistent with our new URL formats such as /my-doc/:discussions",{"_31":9578,"_33":9613},[9579,9590,9601],{"_31":9580,"_33":9581},[],{"_35":2509,"_37":9582,"_39":1823,"_41":9583,"_65":9584,"_67":9589,"_69":68},"A9mFLkBN",{},[9585],{"_35":2483,"_2607":9586,"_2610":9587,"_41":9588,"_69":68},[1111],[1335],{},"Introduce a new /:feed URL format",{"_31":9591,"_33":9592},[],{"_35":2509,"_37":9593,"_39":1823,"_41":9594,"_65":9595,"_67":9600,"_69":68},"GCcM97On",{},[9596],{"_35":2483,"_2607":9597,"_2610":9598,"_41":9599,"_69":68},[4688],[8572],{},"So the site feed for this site is https://seedteamtalks.hyper.media/:feed",{"_31":9602,"_33":9603},[],{"_35":2509,"_37":9604,"_39":1823,"_41":9605,"_65":9606,"_67":9612,"_69":68},"U7sv2j1U",{},[9607],{"_35":2483,"_2607":9608,"_2610":9609,"_41":9611,"_69":68},[6462],[9610],145,{},"And this also opens up the possibility to open the feed for a specific page. If I want to see whats new with all projects, I open /projects/:feed",{"_35":2580,"_37":9614,"_39":1823,"_41":9615,"_65":9616,"_67":9617,"_69":68},"7xIri50P",{"_2582":239},[],"Proposal",{"_31":9619,"_33":9654},[9620,9631,9642],{"_31":9621,"_33":9622},[],{"_35":2509,"_37":9623,"_39":1823,"_41":9624,"_65":9625,"_67":9630,"_69":68},"VQt9hR9q",{},[9626],{"_35":2483,"_2607":9627,"_2610":9628,"_41":9629,"_69":68},[4810],[5262],{},"This is similar but different from the /:activity format because the activity focuses on a single document, while the feed shows you all the things that happen in the whole site or section.",{"_31":9632,"_33":9633},[],{"_35":2509,"_37":9634,"_39":1823,"_41":9635,"_65":9636,"_67":9641,"_69":68},"G7SAqmdu",{},[9637],{"_35":2483,"_2607":9638,"_2610":9639,"_41":9640,"_69":68},[3566],[5946],{},"Maybe we should consider :activity/all or something instead.",{"_31":9643,"_33":9644},[],{"_35":2509,"_37":9645,"_39":1823,"_41":9646,"_65":9647,"_67":9653,"_69":68},"sgbwhmhI",{},[9648],{"_35":2483,"_2607":9649,"_2610":9650,"_41":9652,"_69":68},[6076],[9651],217,{},"Also note that the activity page has filters such as versions or citations. This could be handled with a query param but it is probably better to handle as part of the \"panel param\" because that is sometimes a ?panel= query param, and sometimes is located after the colon in the main path, when the feature is expected to appear in the main panel",{"_35":2580,"_37":9655,"_39":1823,"_41":9656,"_65":9657,"_67":9658,"_69":68},"CWffk_YH",{"_2582":239},[],"Concerns",{"_31":9660,"_33":9695},[9661,9668,9675,9688],{"_31":9662,"_33":9663},[],{"_35":2509,"_37":9664,"_39":1823,"_41":9665,"_65":9666,"_67":9667,"_69":68},"PhuG_hve",{},[],"While writing this document I realized, I have no idea what to do.",{"_31":9669,"_33":9670},[],{"_35":2509,"_37":9671,"_39":1823,"_41":9672,"_65":9673,"_67":9674,"_69":68},"W2wlIBMG",{},[],"We have talked about moving away from the word \"feed\"",{"_31":9676,"_33":9677},[],{"_35":2509,"_37":9678,"_39":1823,"_41":9679,"_65":9680,"_67":9687,"_69":68},"xCiXc-Wg",{},[9681],{"_35":2483,"_2607":9682,"_2610":9684,"_41":9686,"_69":68},[9683],194,[9685],204,{},"But in any case, I believe its very important to have \"recursive activity\" of some kind, so a reader can see all of the recent activity within a site or a section of a site. And definitely, the ?feed=true is an inconsistency in our URL design.",{"_31":9689,"_33":9690},[],{"_35":2509,"_37":9691,"_39":1823,"_41":9692,"_65":9693,"_67":9694,"_69":68},"hEoJ-rKL",{},[],"I'm not sure the solution, but I believe we should solve this soon!\n",{"_35":2580,"_37":9696,"_39":1823,"_41":9697,"_65":9698,"_67":9699,"_69":68},"nEPmtWsI",{"_2582":239},[],"Conclusion",[74],"/tech-talks/proposal-new-feed-url-format",{"_86":1843},{},{"_92":1823,"_96":1841},{"_37":1820,"_104":53,"_54":9706,"_70":1823,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,1822],1778632074340,[158,1820,1823,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/proposal-new-feed-url-format\",\"bafy2bzaceaqrtju2mrzqw2cq2h3dfmzpedak3o3qc4hdhcj36bacv74ynry6c\",true]",{"_119":9711,"_156":10053,"_159":10054},{"_121":9712,"_141":44,"_142":10052,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":9713,"_37":10050},{"_28":9714,"_70":1699,"_71":53,"_72":10045,"_54":10046,"_80":1706,"_82":1706,"_84":10047,"_90":10048,"_92":1699,"_94":10049,"_98":99},[9715,9727,9734,9751,9870,10009],{"_31":9716,"_33":9717},[],{"_35":2509,"_37":9718,"_39":1699,"_41":9719,"_65":9720,"_67":9726,"_69":68},"tmKcOAkB",{},[9721],{"_35":206,"_2607":9722,"_2610":9723,"_41":9724,"_69":9725},[985],[4856],{},"https://catern.com/inheritance.html","Source: https://catern.com/inheritance.html",{"_31":9728,"_33":9729},[],{"_35":2509,"_37":9730,"_39":1699,"_41":9731,"_65":9732,"_67":9733,"_69":68},"BsqVpgLM",{},[],"Inheritance was invented by the Simula language as a way to support intrusive lists, save memory, and simplify the garbage collector.",{"_31":9735,"_33":9736},[],{"_35":2509,"_37":9737,"_39":1699,"_41":9738,"_65":9739,"_67":9750,"_69":68},"NHjkSqmJ",{},[9740,9745],{"_35":206,"_2607":9741,"_2610":9742,"_41":9743,"_69":9744},[4797],[4746],{},"https://en.wikipedia.org/wiki/Inheritance_(object-oriented_programming)",{"_35":206,"_2607":9746,"_2610":9747,"_41":9748,"_69":9749},[5835],[5468],{},"https://www.cs.tufts.edu/comp/150FP/archive/kristen-nygaard/hopl-simula.pdf","It's well known that inheritance was invented by Simula. The History of Programming Languages session on Simula tells us the motivations behind that invention. Let's take a look.",{"_31":9752,"_33":9865},[9753,9765,9791,9815,9822,9829,9854],{"_31":9754,"_33":9755},[],{"_35":2509,"_37":9756,"_39":1699,"_41":9757,"_65":9758,"_67":9764,"_69":68},"CBjixxqK",{},[9759],{"_35":206,"_2607":9760,"_2610":9761,"_41":9762,"_69":9763},[485],[4746],{},"https://en.wikipedia.org/wiki/Composition_over_inheritance","Simula created inheritance instead of using composition because it allowed their garbage collector to be simpler.",{"_31":9766,"_33":9785},[9767,9774],{"_31":9768,"_33":9769},[],{"_35":2509,"_37":9770,"_39":1699,"_41":9771,"_65":9772,"_67":9773,"_69":68},"x6KoAEss",{},[],"Unable to find such a [manual memory allocation] scheme providing sufficient programming flexibility, we implemented a reference count scheme, an idea borrowed from Weizenbaum (1962), and also added a \"last resort\" garbage collector.",{"_31":9775,"_33":9776},[],{"_35":2509,"_37":9777,"_39":1699,"_41":9778,"_65":9779,"_67":9784,"_69":68},"3M2g7Ywc",{},[9780],{"_35":206,"_2607":9781,"_2610":9782,"_41":9783,"_69":9749},[4715],[6573],{},"– Section 2.3.3, The Development Of The Simula Languages",{"_35":2509,"_37":9786,"_39":1699,"_41":9787,"_65":9789,"_67":9790,"_69":68},"vlxaE9To",{"_2582":9788},"Blockquote",[],"Simula had a simple reference counting and garbage collection implementation:",{"_31":9792,"_33":9810},[9793],{"_31":9794,"_33":9805},[9795],{"_31":9796,"_33":9797},[],{"_35":2509,"_37":9798,"_39":1699,"_41":9799,"_65":9800,"_67":9784,"_69":68},"3mHzlp4b",{},[9801],{"_35":206,"_2607":9802,"_2610":9803,"_41":9804,"_69":9749},[4715],[6573],{},{"_35":2509,"_37":9806,"_39":1699,"_41":9807,"_65":9808,"_67":9809,"_69":68},"JFLAseWB",{"_2582":239},[],"A process could outlive its dynamic parent, i.e., the block instance containing the generating expression which gave rise to the process. As a result the process might access nonexisting data through its formal parameters. The remedy chosen was to forbid all kinds of call by name parameters to processes (including procedures, labels, and switches).",{"_35":2509,"_37":9811,"_39":1699,"_41":9812,"_65":9813,"_67":9814,"_69":68},"IVY1CYxH",{"_2582":9788},[],"Using reference counting and garbage collection is fine and good, but their GC was a little too simple:",{"_31":9816,"_33":9817},[],{"_35":2509,"_37":9818,"_39":1699,"_41":9819,"_65":9820,"_67":9821,"_69":68},"qS33bRX0",{},[],"The problem is that one can store a pointer to a stack-allocated variable inside of an object (\"process\", in Simula terminology), then return that object from the scope of that variable, so the stack frame storing the variable is deallocated. That will make later use of that object unsafe: \"the process might access nonexisting data\".",{"_31":9823,"_33":9824},[],{"_35":2509,"_37":9825,"_39":1699,"_41":9826,"_65":9827,"_67":9828,"_69":68},"y5xIzdJ1",{},[],"With more sophisticated garbage collectors, such as the ones used in Lisp even at the time, this is not an issue.",{"_31":9830,"_33":9849},[9831,9838],{"_31":9832,"_33":9833},[],{"_35":2509,"_37":9834,"_39":1699,"_41":9835,"_65":9836,"_67":9837,"_69":68},"vkRvP9ti",{},[],"When writing simulation programs we had observed that processes often shared a number of common properties, both in data attributes and actions, but were structurally different in other respects so that they had to be described by separate declarations. [...] Parametrization could not provide enough flexibility, especially since parameters called by name, including procedure parameters, had been banned for processes (for good reasons, see Section 2.3.3).",{"_31":9839,"_33":9840},[],{"_35":2509,"_37":9841,"_39":1699,"_41":9842,"_65":9843,"_67":9848,"_69":68},"qpVSzdTq",{},[9844],{"_35":206,"_2607":9845,"_2610":9846,"_41":9847,"_69":9749},[1892],[4712],{},"– Section 3.1, The Development Of The Simula Languages",{"_35":2509,"_37":9850,"_39":1699,"_41":9851,"_65":9852,"_67":9853,"_69":68},"UQXQytAt",{"_2582":9788},[],"The simple GC implementation in Simula solved this problem and others by banning passing many things as arguments, including passing functions as arguments. In a sense, they removed the support for first-class functions which existed in ALGOL 60, which Simula was an extension of. Predictably, this reduced the expressivity of the language:",{"_31":9855,"_33":9856},[],{"_35":2509,"_37":9857,"_39":1699,"_41":9858,"_65":9859,"_67":9864,"_69":68},"KR2QBelH",{},[9860],{"_35":206,"_2607":9861,"_2610":9862,"_41":9863,"_69":9763},[5268],[5477],{},"As a result of the limitations of their GC, they weren't able to use \"parametrization\" (what we'd call composition) to customize classes. Instead, they had to invent inheritance.",{"_35":2580,"_37":9866,"_39":1699,"_41":9867,"_65":9868,"_67":9869,"_69":68},"9c0PIKxl",{"_2582":239},[],"Simplifying the garbage collector",{"_31":9871,"_33":10004},[9872,9885,9910,9917,9941,9952,9990,9997],{"_31":9873,"_33":9874},[],{"_35":2509,"_37":9875,"_39":1699,"_41":9876,"_65":9877,"_67":9884,"_69":68},"7qWSIQqy",{},[9878],{"_35":206,"_2607":9879,"_2610":9881,"_41":9882,"_69":9883},[9880],72,[6000],{},"https://stackoverflow.com/questions/3361145/intrusive-lists","Simula's direct inspiration for inheritance was to simplify the usage ofintrusive lists, a clever hack still used today which makes linked lists more efficient, though less flexible.",{"_31":9886,"_33":9905},[9887,9894],{"_31":9888,"_33":9889},[],{"_35":2509,"_37":9890,"_39":1699,"_41":9891,"_65":9892,"_67":9893,"_69":68},"gqMQmc0a",{},[],"In retrospect the introduction of \"multimembership\" sets was a mistake. First the \"sets\" were really process sequences allowing multiple process occurrences, whereas simple process chains would have been more appropriate for most purposes. [...] There was an ever-present overhead in process referencing caused by the fact that all process pointers were directed through separately allocated \"element\" objects.",{"_31":9895,"_33":9896},[],{"_35":2509,"_37":9897,"_39":1699,"_41":9898,"_65":9899,"_67":9904,"_69":68},"DnRRsypQ",{},[9900],{"_35":206,"_2607":9901,"_2610":9902,"_41":9903,"_69":9749},[4715],[6573],{},"– Section 2.3.4, The Development Of The Simula Languages",{"_35":2509,"_37":9906,"_39":1699,"_41":9907,"_65":9908,"_67":9909,"_69":68},"NebJzYiV",{"_2582":9788},[],"In the first version of Simula, before they invented inheritance and other OOP features, they supported a data structure called \"sets\", which were arbitrary linked lists of objects (\"processes\", in Simula terminology):",{"_31":9911,"_33":9912},[],{"_35":2509,"_37":9913,"_39":1699,"_41":9914,"_65":9915,"_67":9916,"_69":68},"5xxCpzDb",{},[],"As usual for a traditional linked list, the linked list nodes (called \"elements\" in the quote) were separately allocated, increasing memory usage and causing memory fragmentation. In comparison, in an intrusive list, the list nodes are not separately allocated.",{"_31":9918,"_33":9936},[9919,9926],{"_31":9920,"_33":9921},[],{"_35":2509,"_37":9922,"_39":1699,"_41":9923,"_65":9924,"_67":9925,"_69":68},"Smr89xRM",{},[],"The element/set concepts were too clumsy as basic, general purpose mechanisms for list processing. Even for simulation modeling our experience showed that simple process pointers might be better, combined with an inherent set membership capability of processes, restricted to one set at a time.",{"_31":9927,"_33":9928},[],{"_35":2509,"_37":9929,"_39":1699,"_41":9930,"_65":9931,"_67":9848,"_69":68},"lh1VUb2A",{},[9932],{"_35":206,"_2607":9933,"_2610":9934,"_41":9935,"_69":9749},[1892],[4712],{},{"_35":2509,"_37":9937,"_39":1699,"_41":9938,"_65":9939,"_67":9940,"_69":68},"DNF1cD3l",{"_2582":9788},[],"In later versions of Simula, they decided that a simpler data structure which didn't allow an object to be in multiple linked lists, and which didn't require inefficient \"element\" objects, would be better:",{"_31":9942,"_33":9943},[],{"_35":2509,"_37":9944,"_39":1699,"_41":9945,"_65":9946,"_67":9951,"_69":68},"npurTvl8",{},[9947],{"_35":206,"_2607":9948,"_2610":9949,"_41":9950,"_69":9883},[2612],[5998],{},"They decided to replace their traditional linked lists withintrusive lists, which are much more memory-efficient and time-efficient than traditional linked lists.",{"_31":9953,"_33":9985},[9954,9961,9968,9975],{"_31":9955,"_33":9956},[],{"_35":2509,"_37":9957,"_39":1699,"_41":9958,"_65":9959,"_67":9960,"_69":68},"Ln9aHVkH",{},[],"The solution came suddenly, with the idea of \"prefixing,\" in December 1966. We were thinking in terms of a toll booth on a bridge, with a queue of cars which were either trucks or buses. (This example reappears in Dahl and Nygaard, 1968.) A \"stripped\" list structure, consisting of a \"set head\" and a variable number of \"links,\" had been written down, when we saw that both our problems could be solved by a mechanism for \"gluing\" each of the various processes (trucks, buses) on to a \"link\" to make each link-process pair one block instance.",{"_31":9962,"_33":9963},[],{"_35":2509,"_37":9964,"_39":1699,"_41":9965,"_65":9966,"_67":9967,"_69":68},"JdnYTd30",{},[],"[...]",{"_31":9969,"_33":9970},[],{"_35":2509,"_37":9971,"_39":1699,"_41":9972,"_65":9973,"_67":9974,"_69":68},"aKgsbqw-",{},[],"Usually a new idea was subjected to rather violent attacks in order to test its strength. The prefix idea was the only exception. We immediately realized that we now had the necessary foundation for a completely new language approach.",{"_31":9976,"_33":9977},[],{"_35":2509,"_37":9978,"_39":1699,"_41":9979,"_65":9980,"_67":9848,"_69":68},"sTiORIYH",{},[9981],{"_35":206,"_2607":9982,"_2610":9983,"_41":9984,"_69":9749},[1892],[4712],{},{"_35":2509,"_37":9986,"_39":1699,"_41":9987,"_65":9988,"_67":9989,"_69":68},"-z8k_4hY",{"_2582":9788},[],"However, intrusive lists require that the linked list node be part of the definition of the class that will be on the list. Traditional composition techniques would be insufficient for this, even if they were available in Simula. The Simula authors didn't know how they'd implement it, until:",{"_31":9991,"_33":9992},[],{"_35":2509,"_37":9993,"_39":1699,"_41":9994,"_65":9995,"_67":9996,"_69":68},"xeaqdkyk",{},[],"In Simula, inheritence was called \"prefixing\"; a base class is a \"prefix\".",{"_31":9998,"_33":9999},[],{"_35":2509,"_37":10000,"_39":1699,"_41":10001,"_65":10002,"_67":10003,"_69":68},"lkn0ldm4",{},[],"So the idea of inheritance originated in the idea of implementing an intrusive list by having objects inherit from the intrusive list node, the \"link\". In this way, intrusive lists, an otherwise complex performance hack, could be easily used.",{"_35":2580,"_37":10005,"_39":1699,"_41":10006,"_65":10007,"_67":10008,"_69":68},"eHTkjGij",{"_2582":239},[],"Supporting intrusive lists",{"_31":10010,"_33":10041},[10011,10018,10025],{"_31":10012,"_33":10013},[],{"_35":2509,"_37":10014,"_39":1699,"_41":10015,"_65":10016,"_67":10017,"_69":68},"RH97E0np",{},[],"It's certainly not bad to create features for performance reasons. And of course, Simula was genius in many other ways. They invented practically every part of modern OOP, not just inheritance; and their use of ubiquitous concurrency in objects is a particularly cool feature that should be copied more.",{"_31":10019,"_33":10020},[],{"_35":2509,"_37":10021,"_39":1699,"_41":10022,"_65":10023,"_67":10024,"_69":68},"bCPd0NRR",{},[],"But it's interesting that no-one today ever talks about inheritance as a performance feature. They talk about the code reuse and extensibility benefits.",{"_31":10026,"_33":10027},[],{"_35":2509,"_37":10028,"_39":1699,"_41":10029,"_65":10030,"_67":10040,"_69":68},"AoleE6BO",{},[10031,10035],{"_35":206,"_2607":10032,"_2610":10033,"_41":10034,"_69":9763},[4746],[4730],{},{"_35":206,"_2607":10036,"_2610":10037,"_41":10038,"_69":10039},[6050],[4782],{},"https://en.wikipedia.org/wiki/Standard_ML#Module_system","Personally, for code reuse and extensibility, I prefer composition and modules.",{"_35":2580,"_37":10042,"_39":1699,"_41":10043,"_65":10044,"_67":9699,"_69":68},"CwLgrpEr",{"_2582":239},[],[77],"/tech-talks/inheritance-was-invented-as-a-performance-hack",{"_86":1719},{},{"_92":1699,"_96":1717},{"_37":1696,"_104":53,"_54":10051,"_70":1699,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,1698],1778632074343,[158,1696,1699,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/inheritance-was-invented-as-a-performance-hack\",\"bafy2bzacebvmjwa6blv2ol2o6kinjhprlpla2hbv2l43tbvbfhxezcgtsyseo\",true]",{"_119":10056,"_156":10076,"_159":10077},{"_121":10057,"_141":44,"_142":10075,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":10058,"_37":10073},{"_28":10059,"_70":1725,"_71":53,"_72":10068,"_54":10069,"_80":1731,"_82":1731,"_84":10070,"_90":10071,"_92":1725,"_94":10072,"_98":99},[10060],{"_31":10061,"_33":10062},[],{"_35":10063,"_37":10064,"_39":1725,"_41":10065,"_65":10066,"_67":68,"_69":10067},"WebEmbed","EaWPsgrS",{},[],"https://x.com/JohannesMutter/status/2023931011046732004?s=20",[77],"/tech-talks/interface-linage",{"_86":1740},{},{"_92":1725,"_96":1738},{"_37":1722,"_104":53,"_54":10074,"_70":1725,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,1724],1778632074305,[158,1722,1725,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/interface-linage\",\"bafy2bzaceclhzdlz3babhlsizutkunvo3tiwiywvxvfmbolwi46uf6sl2l2my\",true]",{"_119":10079,"_156":10105,"_159":10106},{"_121":10080,"_141":44,"_142":10104,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":10081,"_37":10102},{"_28":10082,"_70":1771,"_71":53,"_72":10097,"_54":10098,"_80":1778,"_82":1778,"_84":10099,"_90":10100,"_92":1771,"_94":10101,"_98":99},[10083],{"_31":10084,"_33":10092},[10085],{"_31":10086,"_33":10087},[],{"_35":2687,"_37":10088,"_39":1771,"_41":10089,"_65":10090,"_67":68,"_69":10091},"tB9fMN_Q",{"_2582":239},[],"ipfs://bafkreidv6vftnvqz73jhqef6rhbuwf2mxk5cp26flp2ynz7vopt7pv4w5q",{"_35":2509,"_37":10093,"_39":1771,"_41":10094,"_65":10095,"_67":10096,"_69":68},"S87YUZnY",{"_2582":239},[],"If you instruct an agent to read a seed hypermedia web I would be nice that also read the discussions section as many of the knowledge is buried in comments. This is the kind of specific knowledge that has to be written in a SKILL IMO. But, regardless, if i instruct the agent to go straight to a discussions section then it cant read it. Is there any architecture decision we need to revisit?",[75],"/tech-talks/read-discussions-programatically",{"_86":1791},{},{"_92":1771,"_96":1789},{"_37":1768,"_104":53,"_54":10103,"_70":1771,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,1770],1778632074293,[158,1768,1771,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/read-discussions-programatically\",\"bafy2bzacealurzn3z5kr6ov2mlz4wdnr3tuemmbsacjygldv5fm2bled4vi7o\",true]",{"_119":10108,"_156":10371,"_159":10372},{"_121":10109,"_141":44,"_142":10370,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":10110,"_37":10368},{"_28":10111,"_70":1746,"_71":53,"_72":10362,"_54":10363,"_80":1755,"_82":10364,"_84":10365,"_90":10366,"_92":1756,"_94":10367,"_98":99},[10112,10228,10277,10330],{"_31":10113,"_33":10223},[10114],{"_31":10115,"_33":10218},[10116,10148,10169,10204],{"_31":10117,"_33":10143},[10118,10136],{"_31":10119,"_33":10120},[],{"_35":2509,"_37":10121,"_39":1756,"_41":10122,"_65":10123,"_67":10135,"_69":68},"3LxY1YqN",{},[10124,10129],{"_35":206,"_2607":10125,"_2610":10126,"_41":10127,"_69":10128},[6199],[6072],{},"hm://z6MkfzKMhF9k1oPaQsShWAg8xJzbWf5kaZgn1MkeZvhcAsmB/data?v=bafy2bzacedcc6hpqrlafaeoopzeqkv6gw2afjxuo2aygcden7r7xmvikvsirs&l",{"_35":206,"_2607":10130,"_2610":10131,"_41":10133,"_69":10134},[5286],[10132],207,{},"hm://z6MkfzKMhF9k1oPaQsShWAg8xJzbWf5kaZgn1MkeZvhcAsmB/interfaces/p2p-api?v=bafy2bzacearjhraec6sxlrl426zjtawdsturycg4tnv6x4gzqelsrjhuktcz2&l","For the protocol to gain adoption, developers need to understand the data that gets signed and distributed. And we also need to understand and document the RPCs that are used to communicate between p2p nodes, and what RPCs a single node may expose to its consumers (GUIs, APIs, command lines, agentic access)",{"_31":10137,"_33":10138},[],{"_35":2509,"_37":10139,"_39":1756,"_41":10140,"_65":10141,"_67":10142,"_69":68},"1EuabWsh",{},[],"I suggest a unified system to describe both the verifiable signed data and the APIs, because they have overlapping schemas. For example the \"block type\" which describes chunks of content like paragraphs and images in a document. This type is useful to describe both the node RPCs, and to describe the format of the verifiable signed data.",{"_35":2580,"_37":10144,"_39":1756,"_41":10145,"_65":10146,"_67":10147,"_69":68},"HmME35mT",{"_2582":239},[],"People need to Understand Hypermedia Protocol",{"_31":10149,"_33":10164},[10150,10157],{"_31":10151,"_33":10152},[],{"_35":2509,"_37":10153,"_39":1756,"_41":10154,"_65":10155,"_67":10156,"_69":68},"ENT-b0Gk",{},[],"There are many use cases which the core team cannot support, or does not want to impose on the community. For example if someone in the community wants to experiment with a new form of media like interactive video, they should be able to write software that interacts with the network safely, not breaking other software.",{"_31":10158,"_33":10159},[],{"_35":2509,"_37":10160,"_39":1756,"_41":10161,"_65":10162,"_67":10163,"_69":68},"cvkl-oKc",{},[],"And on the core team, we may want to develop our own experiments and internal tools, while keeping the core documents+comments functionality of the protocol stable.",{"_35":2580,"_37":10165,"_39":1756,"_41":10166,"_65":10167,"_67":10168,"_69":68},"FJHuB6we",{"_2582":239},[],"The Hypermedia Protocol Must be Extensible",{"_31":10170,"_33":10199},[10171,10178,10185,10192],{"_31":10172,"_33":10173},[],{"_35":2509,"_37":10174,"_39":1756,"_41":10175,"_65":10176,"_67":10177,"_69":68},"KcCBHT0Q",{},[],"With a formal schema, we can deliver some useful tools. For example, we could build a GUI that allows us to safely experiment with the raw RPCs and data.",{"_31":10179,"_33":10180},[],{"_35":2509,"_37":10181,"_39":1756,"_41":10182,"_65":10183,"_67":10184,"_69":68},"ADFFDk8m",{},[],"In the signed verifiable data, for example, an IPFS file URL may be encoded as a string (or a raw IPLD CID). But when we expose that to the user, we can offer a file picker. If the schema implies that this should be an image, we can display the image and make sure the user does not select a zip file.",{"_31":10186,"_33":10187},[],{"_35":2509,"_37":10188,"_39":1756,"_41":10189,"_65":10190,"_67":10191,"_69":68},"H7abl8pX",{},[],"Another useful application of a robust schema system is automatically creating type-safe SDKs in many languages, lowering the barrier to entry for developers in different ecosystems to participate in the same data universe.",{"_31":10193,"_33":10194},[],{"_35":2509,"_37":10195,"_39":1756,"_41":10196,"_65":10197,"_67":10198,"_69":68},"wI_GSAoK",{},[],"Also, our APIs may be more robust with a schema system. When a user sends data to an API, we can validate it against schemas and provide detailed errors, telling the user what they did incorrectly.",{"_35":2580,"_37":10200,"_39":1756,"_41":10201,"_65":10202,"_67":10203,"_69":68},"LKr8ygxd",{"_2582":239},[],"Programatic Access to Data and RPCs",{"_31":10205,"_33":10213},[10206],{"_31":10207,"_33":10208},[],{"_35":2509,"_37":10209,"_39":1756,"_41":10210,"_65":10211,"_67":10212,"_69":68},"7g-6dqoM",{},[],"Currently the \"verification\" of the verifiable data simply checks for the signatures and permissions/capabilities of the writer to ensure they are allowed to edit the resource. It does not validate the structural integrity of a resource. For example if a user uploads arbitrary data inside the content of a comment, the system will accept that comment even if it is nonsensical, and the UI will break as a result.",{"_35":2580,"_37":10214,"_39":1756,"_41":10215,"_65":10216,"_67":10217,"_69":68},"_-Srxyx_",{"_2582":239},[],"Protocol Robustness",{"_35":2509,"_37":10219,"_39":1746,"_41":10220,"_65":10221,"_67":10222,"_69":68},"kJAQrRc7",{"_2582":239},[],"We aim to solve a few problems:",{"_35":2580,"_37":10224,"_39":1756,"_41":10225,"_65":10226,"_67":10227,"_69":68},"5Qven48l",{"_2582":239},[],"Problems",{"_31":10229,"_33":10272},[10230,10244,10258],{"_31":10231,"_33":10239},[10232],{"_31":10233,"_33":10234},[],{"_35":2509,"_37":10235,"_39":1756,"_41":10236,"_65":10237,"_67":10238,"_69":68},"VTkBfBkE",{},[],"We have existing data in our system, (DAG-CBOR encoded) which has been signed and then referenced in chains of data. This is basically impossible to change, so we are locked in to certain decisions. The solution is to add a schema system on top of the existing data. New data may reference a schema, and old data will have a fallback schema which matches our current data formats.",{"_35":2580,"_37":10240,"_39":1756,"_41":10241,"_65":10242,"_67":10243,"_69":68},"ZexSDrvQ",{"_2582":239},[],"Support Existing Data",{"_31":10245,"_33":10253},[10246],{"_31":10247,"_33":10248},[],{"_35":2509,"_37":10249,"_39":1756,"_41":10250,"_65":10251,"_67":10252,"_69":68},"kbuyNeXn",{},[],"There must be a system where the data formats can safely evolve, without breaking older software, or software that partially supports the schema.",{"_35":2580,"_37":10254,"_39":1756,"_41":10255,"_65":10256,"_67":10257,"_69":68},"oc_NlDlC",{"_2582":239},[],"Evolution, Partial Compatibility",{"_31":10259,"_33":10267},[10260],{"_31":10261,"_33":10262},[],{"_35":2509,"_37":10263,"_39":1756,"_41":10264,"_65":10265,"_67":10266,"_69":68},"APPZI2Hb",{},[],"Ideally, the community can openly build upon schemas from others in the community. For example, one member of the community might develop a \"livestreaming\" resource, and somebody else could create a more detailed schema which extends it, augmenting with some features. The augmented livestreams must still be usable by the original livestream application. We should not rely on the core team to unlock safe collaboration of new data types in the protocol.",{"_35":2580,"_37":10268,"_39":1756,"_41":10269,"_65":10270,"_67":10271,"_69":68},"Z8-XF9Y0",{"_2582":239},[],"Extendability",{"_35":2580,"_37":10273,"_39":1756,"_41":10274,"_65":10275,"_67":10276,"_69":68},"HjG8xmE6",{"_2582":239},[],"Design Constraints",{"_31":10278,"_33":10326},[10279],{"_31":10280,"_33":10321},[10281,10288,10295,10302,10308,10315],{"_31":10282,"_33":10283},[],{"_35":2509,"_37":10284,"_39":1756,"_41":10285,"_65":10286,"_67":10287,"_69":68},"I7CNtcxy",{},[],"RDF and RDF schema",{"_31":10289,"_33":10290},[],{"_35":2509,"_37":10291,"_39":1756,"_41":10292,"_65":10293,"_67":10294,"_69":68},"QM7K1n43",{},[],"XRPC Lexicons",{"_31":10296,"_33":10297},[],{"_35":2509,"_37":10298,"_39":1756,"_41":10299,"_65":10300,"_67":10301,"_69":68},"JBsG01PA",{},[],"JSON Schema",{"_31":10303,"_33":10304},[],{"_35":2509,"_37":10305,"_39":1756,"_41":10306,"_65":10307,"_67":7324,"_69":68},"NvNFgR_q",{},[],{"_31":10309,"_33":10310},[],{"_35":2509,"_37":10311,"_39":1756,"_41":10312,"_65":10313,"_67":10314,"_69":68},"yWbsfggN",{},[],"protocol buffers",{"_31":10316,"_33":10317},[],{"_35":2509,"_37":10318,"_39":1756,"_41":10319,"_65":10320,"_67":7331,"_69":68},"h06lbW5c",{},[],{"_35":2509,"_37":10322,"_39":1756,"_41":10323,"_65":10324,"_67":10325,"_69":68},"nzePSKPq",{"_2582":2583},[],"Largely undecided! Some things to explore:",{"_35":2580,"_37":10327,"_39":1756,"_41":10328,"_65":10329,"_67":7257,"_69":68},"eteZb5Wm",{"_2582":239},[],{"_31":10331,"_33":10357},[10332,10344],{"_31":10333,"_33":10334},[],{"_35":2509,"_37":10335,"_39":1756,"_41":10336,"_65":10337,"_67":10343,"_69":68},"2eaMdoGK",{},[10338],{"_35":206,"_2607":10339,"_2610":10340,"_41":10341,"_69":10342},[1365],[5835],{},"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/discussions/unified-protocol-types#g1wOXUWA[180:197]","We had a document from last year which discussed this problem. And some others which I can't easily find.",{"_31":10345,"_33":10346},[],{"_35":2509,"_37":10347,"_39":10348,"_41":10349,"_65":10350,"_67":10356,"_69":68},"abT-FPNA","bafy2bzacecs6q52sfjs2y4dnbau3dcdobwbr6qarole3ukcdopw4kc65ugccg",{},[10351],{"_35":4883,"_2607":10352,"_2610":10353,"_41":10354,"_69":10355},[146],[44],{},"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/academic-papers/haystack-a-platform-for-creating-organizing-and-visualizing-information-using-rdf"," ",{"_35":2580,"_37":10358,"_39":1756,"_41":10359,"_65":10360,"_67":10361,"_69":68},"k9a2oqYa",{"_2582":2583},[],"Notes and References",[74,77],"/tech-talks/hypermedia-protocol-schemas","2026-02-15T16:19:20.758Z",{"_86":1765},{},{"_92":1756,"_96":1763},{"_37":1743,"_104":53,"_54":10369,"_70":1746,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,1745],1778632074402,[158,1743,1746,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/hypermedia-protocol-schemas\",\"bafy2bzaceasybr2tdicr7r3775qd4i32pn7gopibtlfg2b5x7s6ad2ihmpqis\",true]",{"_119":10374,"_156":10533,"_159":10534},{"_121":10375,"_141":44,"_142":10532,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":10376,"_37":10530},{"_28":10377,"_70":1849,"_71":53,"_72":10525,"_54":10526,"_80":1856,"_82":1856,"_84":10527,"_90":10528,"_92":1849,"_94":10529,"_98":99},[10378,10385],{"_31":10379,"_33":10380},[],{"_35":2509,"_37":10381,"_39":1849,"_41":10382,"_65":10383,"_67":10384,"_69":68},"XnP5dKBl",{},[],"Get up and running with the dev environment",{"_31":10386,"_33":10520},[10387,10406,10448,10491],{"_31":10388,"_33":10401},[10389],{"_31":10390,"_33":10391},[],{"_35":2509,"_37":10392,"_39":1849,"_41":10393,"_65":10394,"_67":10400,"_69":68},"y2u6EOqJ",{},[10395],{"_35":206,"_2607":10396,"_2610":10397,"_41":10398,"_69":10399},[5454],[485],{},"https://brew.sh/","First, make sure you have homebrew installed to help you get the required software.",{"_35":2580,"_37":10402,"_39":1849,"_41":10403,"_65":10404,"_67":10405,"_69":68},"ZEC9zk2-",{"_2582":239},[],"1. Homebrew",{"_31":10407,"_33":10443},[10408,10415],{"_31":10409,"_33":10410},[],{"_35":2483,"_37":10411,"_39":1849,"_41":10412,"_65":10413,"_67":10414,"_69":68},"9DlEGi1Q",{"_2486":68},[],"brew install direnv yarn mise",{"_31":10416,"_33":10438},[10417,10424,10431],{"_31":10418,"_33":10419},[],{"_35":2509,"_37":10420,"_39":1849,"_41":10421,"_65":10422,"_67":10423,"_69":68},"4ftIlvm4",{},[],"Mise - manages native dependencies",{"_31":10425,"_33":10426},[],{"_35":2509,"_37":10427,"_39":1849,"_41":10428,"_65":10429,"_67":10430,"_69":68},"axpTPLq-",{},[],"Direnv - sets up your local shell environment",{"_31":10432,"_33":10433},[],{"_35":2509,"_37":10434,"_39":1849,"_41":10435,"_65":10436,"_67":10437,"_69":68},"42BKUtsv",{},[],"Yarn - used for frontend installs and tasks",{"_35":2509,"_37":10439,"_39":1849,"_41":10440,"_65":10441,"_67":10442,"_69":68},"fZo04VoO",{"_2582":2583},[],"Currently we require these to be installed.",{"_35":2580,"_37":10444,"_39":1849,"_41":10445,"_65":10446,"_67":10447,"_69":68},"FWG6x4Jk",{"_2582":239},[],"2. Yarn, Direnv, Mise",{"_31":10449,"_33":10486},[10450,10457,10468,10475],{"_31":10451,"_33":10452},[],{"_35":2509,"_37":10453,"_39":1849,"_41":10454,"_65":10455,"_67":10456,"_69":68},"TqkgTTmA",{},[],"To run desktop in dev mode:",{"_31":10458,"_33":10459},[],{"_35":2509,"_37":10460,"_39":1849,"_41":10461,"_65":10462,"_67":10467,"_69":68},"dQ7UXIOZ",{},[10463],{"_35":2483,"_2607":10464,"_2610":10465,"_41":10466,"_69":68},[146],[4715],{},"./dev run-desktop ",{"_31":10469,"_33":10470},[],{"_35":2509,"_37":10471,"_39":1849,"_41":10472,"_65":10473,"_67":10474,"_69":68},"jSzsTChp",{},[],"For a production build:",{"_31":10476,"_33":10477},[],{"_35":2509,"_37":10478,"_39":1849,"_41":10479,"_65":10480,"_67":10485,"_69":68},"-5JQLJdI",{},[10481],{"_35":2483,"_2607":10482,"_2610":10483,"_41":10484,"_69":68},[146],[309],{},"./dev build-desktop",{"_35":2580,"_37":10487,"_39":1849,"_41":10488,"_65":10489,"_67":10490,"_69":68},"627GIvl-",{"_2582":239},[],"3. Desktop Dev",{"_31":10492,"_33":10515},[10493,10504],{"_31":10494,"_33":10495},[],{"_35":2509,"_37":10496,"_39":1849,"_41":10497,"_65":10498,"_67":10503,"_69":68},"KKZJf7Pp",{},[10499],{"_35":2483,"_2607":10500,"_2610":10501,"_41":10502,"_69":68},[6479],[4337],{},"First, install dependencies with yarn",{"_31":10505,"_33":10506},[],{"_35":2509,"_37":10507,"_39":1849,"_41":10508,"_65":10509,"_67":10514,"_69":68},"Ut7TFr9z",{},[10510],{"_35":2483,"_2607":10511,"_2610":10512,"_41":10513,"_69":68},[1421],[6479],{},"Then, run yarn web:dev:standalone",{"_35":2580,"_37":10516,"_39":1849,"_41":10517,"_65":10518,"_67":10519,"_69":68},"cvhEnHmh",{"_2582":239},[],"4. Web Dev",{"_35":2580,"_37":10521,"_39":1849,"_41":10522,"_65":10523,"_67":10524,"_69":68},"GD6t1Q1e",{"_2582":239},[],"MacOS",[74],"/tech-talks/dev-machine-setup",{"_86":1868},{},{"_92":1849,"_96":1866},{"_37":1846,"_104":53,"_54":10531,"_70":1849,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,1848],1778632074412,[158,1846,1849,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/dev-machine-setup\",\"bafy2bzaceb2ulgeaa6xsnwlodgdpo4rk42exxagzkfospnpay32z2d3ilspiw\",true]",{"_119":10536,"_156":10885,"_159":10886},{"_121":10537,"_141":44,"_142":10884,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":10538,"_37":10882},{"_28":10539,"_70":1874,"_71":53,"_72":10876,"_54":10877,"_80":1882,"_82":10878,"_84":10879,"_90":10880,"_92":1883,"_94":10881,"_98":99},[10540,10607,10665,10733,10810],{"_31":10541,"_33":10603},[10542,10549,10561,10576,10589,10596],{"_31":10543,"_33":10544},[],{"_35":2509,"_37":10545,"_39":1883,"_41":10546,"_65":10547,"_67":10548,"_69":68},"rlu-MM8W",{},[],"When we first integrated electron-trpc into our Electron desktop application, the promise was compelling: end-to-end type safety, a single source of truth for our API layer, and the developer experience benefits of autocomplete and automatic refactoring. What we didn't anticipate was the performance tax we'd be paying at runtime—a cost our users bear every time they launch the application.",{"_31":10550,"_33":10551},[],{"_35":2509,"_37":10552,"_39":1883,"_41":10553,"_65":10554,"_67":10560,"_69":68},"P1K-EUgc",{},[10555],{"_35":2483,"_2607":10556,"_2610":10557,"_41":10559,"_69":68},[7473],[10558],175,{},"The reality is clear. Our current implementation forces every data access through a seven-layer abstraction stack: from UI components through the tRPC client, into the ipcLink adapter, across Electron's IPC boundary, through the main process IPC handler, into the router, and finally to the procedure implementation. Compare this to standard Electron IPC, which requires only three layers: component to contextBridge API to IPC handler. We're paying a 133% complexity tax for type safety that exists only during development.",{"_31":10562,"_33":10563},[],{"_35":2509,"_37":10564,"_39":1883,"_41":10565,"_65":10566,"_67":10575,"_69":68},"dtRXYnh0",{},[10567],{"_35":2483,"_2607":10568,"_2610":10571,"_41":10574,"_69":68},[10569,10570],269,288,[10572,10573],284,310,{},"The numbers tell a sobering story. I analyzed our codebase and found 109 tRPC procedures across 26 modules, totaling 3,615 lines of code—roughly 40% of our entire desktop application codebase. Of these 109 procedures, 42 are simple getters and setters: operations like getSetting(key) or setFavorite(id, value). These trivial operations gain nothing from tRPC's sophisticated machinery, yet they still pay the full cost of serialization, deserialization, router traversal, and type inference at runtime.",{"_31":10577,"_33":10578},[],{"_35":2509,"_37":10579,"_39":1883,"_41":10580,"_65":10581,"_67":10588,"_69":68},"uHzo1lTK",{},[10582],{"_35":2722,"_2607":10583,"_2610":10585,"_41":10587,"_69":68},[10584],558,[10586],587,{},"The bundle size impact is measurable: 28KB of additional JavaScript (tRPC client, SuperJSON transformer, and electron-trpc itself) that gets parsed and evaluated during startup. But the real performance killer isn't the bundle size—it's the runtime overhead. Every single call requires SuperJSON to serialize the request, send it across IPC, deserialize on the main process side, traverse the router tree, execute the procedure, serialize the response, send it back across IPC, and deserialize again. For a simple getter that returns a boolean, this is like using a shotgun to kill a fly.",{"_31":10590,"_33":10591},[],{"_35":2509,"_37":10592,"_39":1883,"_41":10593,"_65":10594,"_67":10595,"_69":68},"k4hzQ42T",{},[],"Perhaps most troubling is what we discovered about our startup sequence. Because all 26 tRPC modules are eagerly loaded at application start, we're forcing the JavaScript engine to parse and evaluate thousands of lines of API code even for routes the user may never visit. There's no code splitting, no lazy loading, no optimization for the critical path. Every user pays the full cost of our entire API surface, regardless of which features they actually use.",{"_31":10597,"_33":10598},[],{"_35":2687,"_37":10599,"_39":1874,"_41":10600,"_65":10601,"_67":68,"_69":10602},"C55Pjxeo",{"_2582":239},[],"ipfs://bafybeieypd2gtgbttltmj5cmlvi2taakxt4cmnjfizbrrmoub2bjlw5imi",{"_35":2580,"_37":10604,"_39":1883,"_41":10605,"_65":10606,"_67":7153,"_69":68},"B10HQgrv",{"_2582":239},[],{"_31":10608,"_33":10661},[10609,10616,10628,10635,10648],{"_31":10610,"_33":10611},[],{"_35":2509,"_37":10612,"_39":1883,"_41":10613,"_65":10614,"_67":10615,"_69":68},"9lb9xx2F",{},[],"The path forward requires surgical precision, not wholesale replacement. We don't need to rip out electron-trpc entirely—we need to recognize where it adds value and where it extracts a performance cost that exceeds its benefits.",{"_31":10617,"_33":10618},[],{"_35":2509,"_37":10619,"_39":1883,"_41":10620,"_65":10621,"_67":10627,"_69":68},"TNrX6TZy",{},[10622],{"_35":2483,"_2607":10623,"_2610":10624,"_41":10626,"_69":68},[9095],[10625],157,{},"For the 39% of our procedures that are simple getters and setters, standard Electron IPC is the clear winner. A function like getSetting(key: string): string doesn't need Zod validation, doesn't benefit from complex type inference, and certainly doesn't warrant the overhead of SuperJSON transformation. These should be implemented as direct IPC calls exposed through contextBridge, giving us type safety at the interface boundary without the runtime overhead. We can still maintain TypeScript types for these APIs—they just won't be automatically derived from tRPC routers.",{"_31":10629,"_33":10630},[],{"_35":2509,"_37":10631,"_39":1883,"_41":10632,"_65":10633,"_67":10634,"_69":68},"rXae6BBm",{},[],"For complex operations—draft management with its file I/O and migration logic, web content importing with its multi-step transformations, or any procedure with sophisticated input validation—electron-trpc remains valuable. These operations already have significant execution time measured in hundreds of milliseconds, so the additional IPC overhead is noise. The type safety and validation genuinely prevent bugs in these complex code paths.",{"_31":10636,"_33":10637},[],{"_35":2509,"_37":10638,"_39":1883,"_41":10639,"_65":10640,"_67":10647,"_69":68},"ZU4ZlRQz",{},[10641],{"_35":2483,"_2607":10642,"_2610":10644,"_41":10646,"_69":68},[10643],362,[10645],378,{},"The second critical change is implementing proper code splitting. Our tRPC routers should be lazy-loaded by feature area. When a user opens the settings window, that's when we load the settings router. When they access drafts, that's when the drafts API becomes available. This requires restructuring our router tree to support dynamic imports and deferring the createIPCHandler call until routers are actually needed. It's more complex than our current eager-loading approach, but it's the difference between a 2-second startup and a 5-second startup.",{"_31":10649,"_33":10650},[],{"_35":2509,"_37":10651,"_39":1883,"_41":10652,"_65":10653,"_67":10660,"_69":68},"KviZ4y8T",{},[10654],{"_35":2722,"_2607":10655,"_2610":10657,"_41":10659,"_69":68},[10656],508,[10658],564,{},"Finally, we need to stop blocking the window creation on our full initialization sequence. The current pattern—spawn daemon, wait for it to become ready (up to 10 seconds), initialize drafts with file I/O, then finally show the window—is user-hostile. Instead, we should show the window immediately with a proper loading state, then initialize the daemon and drafts in parallel while providing real-time progress updates. This isn't strictly an electron-trpc issue, but it's symptomatic of the same mindset: prioritizing developer convenience over user experience.",{"_35":2580,"_37":10662,"_39":1883,"_41":10663,"_65":10664,"_67":7257,"_69":68},"TF1EKkKj",{"_2582":239},[],{"_31":10666,"_33":10728},[10667,10674,10689,10708,10715],{"_31":10668,"_33":10669},[],{"_35":2509,"_37":10670,"_39":1883,"_41":10671,"_65":10672,"_67":10673,"_69":68},"iX8Miwjm",{},[],"The most dangerous rabbit hole when migrating away from electron-trpc is the temptation to build your own type-safe IPC abstraction. You'll be tempted to think:",{"_31":10675,"_33":10676},[],{"_35":2509,"_37":10677,"_39":1883,"_41":10678,"_65":10679,"_67":10688,"_69":68},"HHZWS8ko",{},[10680,10684],{"_35":7569,"_2607":10681,"_2610":10682,"_41":10683,"_69":68},[44],[6000],{},{"_35":2722,"_2607":10685,"_2610":10686,"_41":10687,"_69":68},[8300],[4747],{},"\"we can keep the type safety without the overhead by building a lighter-weight version.\" Don't.",{"_31":10690,"_33":10691},[],{"_35":2509,"_37":10692,"_39":1883,"_41":10693,"_65":10694,"_67":10707,"_69":68},"xnDoDSK_",{},[10695,10701],{"_35":2722,"_2607":10696,"_2610":10698,"_41":10700,"_69":68},[10697],299,[10699],321,{},{"_35":2483,"_2607":10702,"_2610":10704,"_41":10706,"_69":68},[10703],343,[10705],361,{},"The complexity of maintaining type synchronization between main and renderer processes, handling serialization edge cases, managing subscriptions, and keeping everything working as your API evolves will consume weeks of engineering time for marginal gains. If you're moving away from electron-trpc, move toward simplicity, not toward building electron-trpc-lite.",{"_31":10709,"_33":10710},[],{"_35":2509,"_37":10711,"_39":1883,"_41":10712,"_65":10713,"_67":10714,"_69":68},"Qw2TvnRq",{},[],"Another trap is trying to maintain 100% feature parity during migration. You'll find yourself recreating tRPC's subscription mechanism, its batching capabilities, its middleware system. Each recreation adds back the complexity you're trying to remove. Instead, ask whether you actually use these features. In our codebase, we use subscriptions in exactly one place for query invalidation—we could replace that with a simple event emitter in five minutes. Batching? We're not making multiple related calls that would benefit from it. Middleware? We don't have any. Don't rebuild features you're not using.",{"_31":10716,"_33":10717},[],{"_35":2509,"_37":10718,"_39":1883,"_41":10719,"_65":10720,"_67":10727,"_69":68},"-ChEbuHd",{},[10721],{"_35":2722,"_2607":10722,"_2610":10724,"_41":10726,"_69":68},[10723],516,[10725],541,{},"The third rabbit hole is perfectionism around migration strategy. You'll want to create detailed plans for migrating all 109 procedures, establishing patterns, writing comprehensive tests for the new IPC layer. This planning phase will expand to fill weeks while your users continue to experience slow startup times. Instead, pick the lowest-hanging fruit—those 42 simple getters and setters—and migrate them in a single focused session. Prove the pattern works, measure the impact, then decide whether to continue. Progress beats perfection.",{"_35":2580,"_37":10729,"_39":1883,"_41":10730,"_65":10731,"_67":10732,"_69":68},"nRwAMhpG",{"_2582":239},[],"Rabbit Holes",{"_31":10734,"_33":10805},[10735,10746,10765,10772,10785,10792],{"_31":10736,"_33":10737},[],{"_35":2509,"_37":10738,"_39":1883,"_41":10739,"_65":10740,"_67":10745,"_69":68},"UNaxdog2",{},[10741],{"_35":2483,"_2607":10742,"_2610":10743,"_41":10744,"_69":68},[8572],[6071],{},"The scope of this effort is deliberately constrained. We're not removing electron-trpc entirely, we're not rewriting the entire IPC layer, and we're not solving every performance issue in the application. We're making three targeted changes that address the most egregious performance problems with the highest return on investment.",{"_31":10747,"_33":10748},[],{"_35":2509,"_37":10749,"_39":1883,"_41":10750,"_65":10751,"_67":10764,"_69":68},"w6AEuv8L",{},[10752],{"_35":2483,"_2607":10753,"_2610":10758,"_41":10763,"_69":68},[10754,10755,10756,10757],344,386,472,481,[10759,10760,10761,10762],357,393,476,490,{},"First, migrate simple getters and setters (the 42 identified procedures) to direct IPC. This includes settings, favorites, recents, and similar single-value operations. These should be completed in a single pull request to avoid having two patterns for simple operations living in the codebase simultaneously. The pattern should be consistent: contextBridge exposes a typed API object, ipcMain handlers implement the logic, and components use the exposed API directly. No tRPC, no SuperJSON, no router traversal.",{"_31":10766,"_33":10767},[],{"_35":2509,"_37":10768,"_39":1883,"_41":10769,"_65":10770,"_67":10771,"_69":68},"IcUzDYbF",{},[],"Second, implement lazy loading for tRPC routers that remain. This means splitting the monolithic router into feature-based modules that can be dynamically imported. The drafts router loads when the drafts feature is accessed. The web importing router loads when import functionality is needed. The settings router can stay eagerly loaded since it's needed for initial app configuration. This will require modifying how we create the IPC handlers and potentially introducing a router registry pattern, but it's a one-time infrastructure change that benefits all routers.",{"_31":10773,"_33":10774},[],{"_35":2509,"_37":10775,"_39":1883,"_41":10776,"_65":10777,"_67":10784,"_69":68},"wpeUixFL",{},[10778],{"_35":2483,"_2607":10779,"_2610":10781,"_41":10783,"_69":68},[5470,10780],417,[5289,10782],430,{},"Third, improve the startup sequence to handle daemon initialization gracefully. Work is already underway in the feat/app-startup branch to check daemon state and show a dedicated loading window when the daemon is migrating, rather than blocking the main window creation. This approach gives users immediate visual feedback and prevents the blank screen experience during daemon startup. While not strictly related to electron-trpc, it's the most visible performance problem users experience, and completing this work removes the artificial coupling between daemon readiness and window visibility.",{"_31":10786,"_33":10787},[],{"_35":2687,"_37":10788,"_39":1874,"_41":10789,"_65":10790,"_67":68,"_69":10791},"kA2pfoLW",{"_2582":239},[],"ipfs://bafybeiawbu3w7d6vszex3jf2qj2a6hu7iefhag7bo6tfdi6ac3sakmmpqm",{"_31":10793,"_33":10794},[],{"_35":2509,"_37":10795,"_39":1883,"_41":10796,"_65":10797,"_67":10804,"_69":68},"9XZUZFxu",{},[10798],{"_35":7569,"_2607":10799,"_2610":10801,"_41":10803,"_69":68},[10800],243,[10802],252,{},"What's explicitly out of scope: rewriting complex operations like draft management or web importing. These procedures have sophisticated logic and benefit from tRPC's type safety. Also out of scope: building abstractions to make the migration \"cleaner\" or trying to maintain identical APIs between the old and new approaches. Different paradigms can have different interfaces—that's fine.",{"_35":2580,"_37":10806,"_39":1883,"_41":10807,"_65":10808,"_67":10809,"_69":68},"hQ5Ujb2_",{"_2582":239},[],"Scope",{"_31":10811,"_33":10871},[10812,10823,10830,10842,10849],{"_31":10813,"_33":10814},[],{"_35":2509,"_37":10815,"_39":1883,"_41":10816,"_65":10817,"_67":10822,"_69":68},"Z9t6DXex",{},[10818],{"_35":2722,"_2607":10819,"_2610":10820,"_41":10821,"_69":68},[146],[177],{},"Do not attempt to build a custom type-safe IPC framework as part of this effort. The goal is to reduce complexity, not to replace one abstraction with another that we have to maintain. If you find yourself writing code that generates types from schemas or automatically syncs interfaces between processes, stop immediately. You're rebuilding tRPC and you will regret it.",{"_31":10824,"_33":10825},[],{"_35":2509,"_37":10826,"_39":1883,"_41":10827,"_65":10828,"_67":10829,"_69":68},"q3AzVdHa",{},[],"Do not migrate complex procedures away from electron-trpc just for consistency. If a procedure has multiple input parameters, complex validation logic, or sophisticated error handling, it's probably fine to keep it in tRPC. The performance overhead is only problematic when it's disproportionate to the operation's inherent cost. A draft creation operation that does file I/O, validation, and database writes can afford an extra 2 milliseconds of IPC overhead. A boolean getter cannot.",{"_31":10831,"_33":10832},[],{"_35":2509,"_37":10833,"_39":1883,"_41":10834,"_65":10835,"_67":10841,"_69":68},"37GrdmuE",{},[10836],{"_35":2722,"_2607":10837,"_2610":10838,"_41":10840,"_69":68},[6012],[10839],375,{},"Do not introduce new dependencies to solve these problems. There will be temptation to bring in libraries for IPC message validation, for type generation, for performance monitoring. Each dependency is a future maintenance burden and a potential attack surface. Electron's built-in IPC with TypeScript interfaces is sufficient for our needs in this particular simple usecases. If it feels too manual compared to tRPC, that's because you're doing less work at runtime—which is the entire point.",{"_31":10843,"_33":10844},[],{"_35":2509,"_37":10845,"_39":1883,"_41":10846,"_65":10847,"_67":10848,"_69":68},"6VqWIsKJ",{},[],"Do not skip measuring the impact of changes. Before migrating procedures, establish baseline metrics: startup time, time to first render, bundle size. After migration, measure again. If you're not seeing measurable improvements, you may be optimizing the wrong thing. Performance work without measurement is just guessing, and guessing wastes time that could be spent on features users actually want.",{"_31":10850,"_33":10851},[],{"_35":2509,"_37":10852,"_39":1883,"_41":10853,"_65":10854,"_67":10870,"_69":68},"qSPrTxzY",{},[10855,10861],{"_35":2483,"_2607":10856,"_2610":10858,"_41":10860,"_69":68},[5266,10857],384,[6050,10859],397,{},{"_35":7569,"_2607":10862,"_2610":10866,"_41":10869,"_69":68},[10863,10864,10865],191,213,246,[9683,10867,10868],216,249,{},"Finally, do not let this migration become a referendum on electron-trpc as a technology. It's a well-built library that solves real problems for many applications. It's not the right fit for our application given our performance requirements and our API patterns. That's a specific conclusion about specific circumstances, not a universal truth. When you're done with this migration, electron-trpc will still be a good choice for applications where the DX benefits outweigh the runtime costs—applications with complex APIs, web-based backends that need IPC adapters, or tools where load time isn't critical. We're just not one of those applications.",{"_35":2580,"_37":10872,"_39":1883,"_41":10873,"_65":10874,"_67":10875,"_69":68},"ZU3bw_ZC",{"_2582":239},[],"No-Gos",[78],"/tech-talks/the-case-against-electron-trpc-when-type-safety-becomes-a-performance-tax","2025-12-19T17:26:27.410Z",{"_86":1897,"_88":1898,"_192":1899},{},{"_92":1883,"_96":1895},{"_37":1871,"_104":53,"_54":10883,"_70":1874,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,1873],1778632074502,[158,1871,1874,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/the-case-against-electron-trpc-when-type-safety-becomes-a-performance-tax\",\"bafy2bzaceamy4oebix7slrvg7fdk3hm3rxmbsvu7ergjp54tkckt664x642vg\",true]",{"_119":10888,"_156":12618,"_159":12619},{"_121":10889,"_141":44,"_142":12617,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":10890,"_37":12615},{"_28":10891,"_70":1905,"_71":53,"_72":12609,"_54":12610,"_80":1914,"_82":12611,"_84":12612,"_90":12613,"_92":1915,"_94":12614,"_98":99},[10892,10960,11051,11478,11869,12240,12336,12488,12553],{"_31":10893,"_33":10955},[10894,10927],{"_31":10895,"_33":10922},[10896,10907],{"_31":10897,"_33":10898},[],{"_35":2509,"_37":10899,"_39":1915,"_41":10900,"_65":10901,"_67":10906,"_69":68},"sMe1bJ4Z",{},[10902],{"_35":2722,"_2607":10903,"_2610":10904,"_41":10905,"_69":68},[146,2357],[1257,3566],{},"Date: December 2025 Issue: Perceived performance regression after SSR implementation",{"_31":10908,"_33":10909},[],{"_35":2509,"_37":10910,"_39":1915,"_41":10911,"_65":10912,"_67":10921,"_69":68},"qP22V8SY",{},[10913,10917],{"_35":2722,"_2607":10914,"_2610":10915,"_41":10916,"_69":68},[146],[1421],{},{"_35":2483,"_2607":10918,"_2610":10919,"_41":10920,"_69":68},[309],[4780],{},"Root Cause: Commit deea8a4bf (\"Attempt to streamline server rendering loaders\") removed query block prefetching logic, causing client-side waterfall fetches for pages with Query blocks.",{"_35":2580,"_37":10923,"_39":1915,"_41":10924,"_65":10925,"_67":10926,"_69":68},"7MLS6D-c",{"_2582":239},[],"Performance Regression Identified",{"_31":10928,"_33":10950},[10929,10936,10943],{"_31":10930,"_33":10931},[],{"_35":2509,"_37":10932,"_39":1915,"_41":10933,"_65":10934,"_67":10935,"_69":68},"KfR5aN-I",{},[],"Pages with Query blocks now trigger multiple client-side round trips instead of being server-rendered",{"_31":10937,"_33":10938},[],{"_35":2509,"_37":10939,"_39":1915,"_41":10940,"_65":10941,"_67":10942,"_69":68},"Xgz91EEb",{},[],"Lost ~67 lines of critical prefetching code",{"_31":10944,"_33":10945},[],{"_35":2509,"_37":10946,"_39":1915,"_41":10947,"_65":10948,"_67":10949,"_69":68},"aCc_OUaM",{},[],"Estimated performance degradation: 50-70% slower for query-heavy pages",{"_35":2580,"_37":10951,"_39":1915,"_41":10952,"_65":10953,"_67":10954,"_69":68},"rkuGP7zu",{"_2582":2583},[],"Impact",{"_35":2580,"_37":10956,"_39":1915,"_41":10957,"_65":10958,"_67":10959,"_69":68},"COxk496R",{"_2582":239},[],"Background",{"_31":10961,"_33":11046},[10962],{"_31":10963,"_33":11041},[10964,10979,11022,11033],{"_31":10965,"_33":10966},[],{"_35":2509,"_37":10967,"_39":1915,"_41":10968,"_65":10969,"_67":10978,"_69":68},"-6u65yGY",{},[10970,10974],{"_35":2722,"_2607":10971,"_2610":10972,"_41":10973,"_69":68},[146,4810],[1257,485],{},{"_35":2483,"_2607":10975,"_2610":10976,"_41":10977,"_69":68},[577],[5946],{},"File: frontend/apps/web/app/loaders.ts Lines: 317-357",{"_31":10980,"_33":11013},[10981,10988,10995,11002],{"_31":10982,"_33":10983},[],{"_35":2509,"_37":10984,"_39":1915,"_41":10985,"_65":10986,"_67":10987,"_69":68},"uQ490CZQ",{},[],"Query block extraction from document content",{"_31":10989,"_33":10990},[],{"_35":2509,"_37":10991,"_39":1915,"_41":10992,"_65":10993,"_67":10994,"_69":68},"1wIsjEW6",{},[],"Server-side query execution",{"_31":10996,"_33":10997},[],{"_35":2509,"_37":10998,"_39":1915,"_41":10999,"_65":11000,"_67":11001,"_69":68},"P5cyq9x1",{},[],"Prefetching of all query result documents",{"_31":11003,"_33":11004},[],{"_35":2509,"_37":11005,"_39":1915,"_41":11006,"_65":11007,"_67":11012,"_69":68},"ghtysyiH",{},[11008],{"_35":2483,"_2607":11009,"_2610":11010,"_41":11011,"_69":68},[3886],[2727],{},"Graceful error handling with Promise.allSettled",{"_35":2509,"_37":11014,"_39":1915,"_41":11015,"_65":11016,"_67":11021,"_69":68},"wM-B4-c6",{"_2582":2878},[11017],{"_35":2722,"_2607":11018,"_2610":11019,"_41":11020,"_69":68},[146],[985],{},"Restored:",{"_31":11023,"_33":11024},[],{"_35":2509,"_37":11025,"_39":1915,"_41":11026,"_65":11027,"_67":11032,"_69":68},"Qt_b90_k",{},[11028],{"_35":2722,"_2607":11029,"_2610":11030,"_41":11031,"_69":68},[146],[1421],{},"Code Added:",{"_31":11034,"_33":11035},[],{"_35":2483,"_37":11036,"_39":1915,"_41":11037,"_65":11039,"_67":11040,"_69":68},"3neqRv2l",{"_2486":11038},"typescript",[],"// CRITICAL: Extract and prefetch query blocks (RESTORED)\nconst queryBlocks = extractQueryBlocks(document.content)\n\nif (queryBlocks.length > 0) {\n await instrument(ctx || noopCtx, 'prefetchQueryBlocks', async () => {\n const queryBlockQueries = await Promise.all(\n queryBlocks.map(async (block) => {\n try {\n return await getQueryResults(block.attributes.query)\n } catch (e) {\n console.error('Error executing query block', e)\n return null\n }\n }),\n )\n\n // Add query result documents to embeddedDocs for prefetching\n const queryResultDocs = await Promise.allSettled(\n queryBlockQueries\n .filter((item) => item !== null && item.results)\n .flatMap((item) => item!.results)\n .map(async (item) => {\n try {\n const id = item.id\n const document = await getDocument(id)\n return {id, document}\n } catch (e) {\n console.error('Error fetching query result document', item.id, e)\n return null\n }\n }),\n )\n\n // Add successfully fetched query result docs to embeddedDocs\n queryResultDocs.forEach((result) => {\n if (result.status === 'fulfilled' && result.value) {\n embeddedDocs.push(result.value)\n }\n })\n })\n}\n",{"_35":2580,"_37":11042,"_39":1915,"_41":11043,"_65":11044,"_67":11045,"_69":68},"qmtZJidw",{"_2582":239},[],"Changes Made",{"_35":2580,"_37":11047,"_39":1915,"_41":11048,"_65":11049,"_67":11050,"_69":68},"_OVWLPoP",{"_2582":239},[],"Phase 1: Fix Regression (COMPLETED)",{"_31":11052,"_33":11473},[11053],{"_31":11054,"_33":11468},[11055,11062,11150,11241,11388],{"_31":11056,"_33":11057},[],{"_35":2509,"_37":11058,"_39":1915,"_41":11059,"_65":11060,"_67":11061,"_69":68},"itI-er-f",{},[],"Based on analysis of the SSR implementation, the following bottlenecks were identified:",{"_31":11063,"_33":11141},[11064,11079,11090,11097],{"_31":11065,"_33":11066},[],{"_35":2509,"_37":11067,"_39":1915,"_41":11068,"_65":11069,"_67":11078,"_69":68},"RbH525_8",{},[11070,11074],{"_35":2722,"_2607":11071,"_2610":11072,"_41":11073,"_69":68},[146,4337,5837],[1257,711,7165],{},{"_35":2483,"_2607":11075,"_2610":11076,"_41":11077,"_69":68},[577],[2883],{},"File: frontend/apps/web/app/root.tsx Issue: No preconnect or dns-prefetch hints for external services Impact: ~100-300ms overhead per origin for DNS + TLS",{"_31":11080,"_33":11081},[],{"_35":2509,"_37":11082,"_39":1915,"_41":11083,"_65":11084,"_67":11089,"_69":68},"sGovS3T_",{},[11085],{"_35":2722,"_2607":11086,"_2610":11087,"_41":11088,"_69":68},[146],[4700],{},"Current State:",{"_31":11091,"_33":11092},[],{"_35":2483,"_37":11093,"_39":1915,"_41":11094,"_65":11095,"_67":11096,"_69":68},"G7_6t1m1",{"_2486":11038},[],"export const links: LinksFunction = () => {\n return [\n {rel: 'stylesheet', href: globalStyles},\n {rel: 'stylesheet', href: localTailwindStyles},\n {rel: 'stylesheet', href: sonnerStyles},\n {rel: 'stylesheet', href: slashMenuStyles},\n ]\n}\n",{"_31":11098,"_33":11132},[11099,11110,11121],{"_31":11100,"_33":11101},[],{"_35":2509,"_37":11102,"_39":1915,"_41":11103,"_65":11104,"_67":11109,"_69":68},"06bOtqVb",{},[11105],{"_35":2483,"_2607":11106,"_2610":11107,"_41":11108,"_69":68},[146,4808],[1892,6479],{},"DAEMON_HTTP_URL / SEED_ASSET_HOST - Main backend API",{"_31":11111,"_33":11112},[],{"_35":2509,"_37":11113,"_39":1915,"_41":11114,"_65":11115,"_67":11120,"_69":68},"Xp5TYkJi",{},[11116],{"_35":2483,"_2607":11117,"_2610":11118,"_41":11119,"_69":68},[146],[4715],{},"LIGHTNING_API_URL - Lightning network API",{"_31":11122,"_33":11123},[],{"_35":2509,"_37":11124,"_39":1915,"_41":11125,"_65":11126,"_67":11131,"_69":68},"QxfcBr3M",{},[11127],{"_35":2483,"_2607":11128,"_2610":11129,"_41":11130,"_69":68},[146],[309],{},"NOTIFY_SERVICE_HOST - Notification service",{"_35":2509,"_37":11133,"_39":1915,"_41":11134,"_65":11135,"_67":11140,"_69":68},"9hFKL-SA",{"_2582":2583},[11136],{"_35":2722,"_2607":11137,"_2610":11138,"_41":11139,"_69":68},[146],[1335],{},"Services to preconnect:",{"_35":2580,"_37":11142,"_39":1915,"_41":11143,"_65":11144,"_67":11149,"_69":68},"WDHlk1mL",{"_2582":239},[11145],{"_35":2722,"_2607":11146,"_2610":11147,"_41":11148,"_69":68},[172],[2357],{},"1. No Resource Hints",{"_31":11151,"_33":11232},[11152,11167,11182,11193,11200],{"_31":11153,"_33":11154},[],{"_35":2509,"_37":11155,"_39":1915,"_41":11156,"_65":11157,"_67":11166,"_69":68},"laA1a2Vf",{},[11158,11162],{"_35":2722,"_2607":11159,"_2610":11160,"_41":11161,"_69":68},[146,711],[1257,2727],{},{"_35":2483,"_2607":11163,"_2610":11164,"_41":11165,"_69":68},[577],[5986],{},"File: frontend/apps/web/app/providers.tsx Lines: 38-49",{"_31":11168,"_33":11169},[],{"_35":2509,"_37":11170,"_39":1915,"_41":11171,"_65":11172,"_67":11181,"_69":68},"Iivcsnif",{},[11173,11177],{"_35":2722,"_2607":11174,"_2610":11175,"_41":11176,"_69":68},[146],[740],{},{"_35":2483,"_2607":11178,"_2610":11179,"_41":11180,"_69":68},[1306],[5454],{},"Issue: staleTime: Infinity prevents background data freshness",{"_31":11183,"_33":11184},[],{"_35":2509,"_37":11185,"_39":1915,"_41":11186,"_65":11187,"_67":11192,"_69":68},"Z326Tel-",{},[11188],{"_35":2722,"_2607":11189,"_2610":11190,"_41":11191,"_69":68},[146],[840],{},"Current Config:",{"_31":11194,"_33":11195},[],{"_35":2483,"_37":11196,"_39":1915,"_41":11197,"_65":11198,"_67":11199,"_69":68},"aDiUcuIw",{"_2486":11038},[],"function createQueryClient() {\n return new QueryClient({\n defaultOptions: {\n queries: {\n staleTime: Infinity, // ⚠️ Never considers data stale\n refetchOnMount: false,\n refetchOnWindowFocus: false,\n refetchOnReconnect: false,\n },\n },\n })\n}\n",{"_31":11201,"_33":11223},[11202,11209,11216],{"_31":11203,"_33":11204},[],{"_35":2509,"_37":11205,"_39":1915,"_41":11206,"_65":11207,"_67":11208,"_69":68},"R6LROA3p",{},[],"Good for SSR cache",{"_31":11210,"_33":11211},[],{"_35":2509,"_37":11212,"_39":1915,"_41":11213,"_65":11214,"_67":11215,"_69":68},"B7OfyOoj",{},[],"Bad for client-side navigation (no fresh data checks)",{"_31":11217,"_33":11218},[],{"_35":2509,"_37":11219,"_39":1915,"_41":11220,"_65":11221,"_67":11222,"_69":68},"gLNhRgRH",{},[],"Users see stale data even after long sessions",{"_35":2509,"_37":11224,"_39":1915,"_41":11225,"_65":11226,"_67":11231,"_69":68},"s-dP1f73",{"_2582":2583},[11227],{"_35":2722,"_2607":11228,"_2610":11229,"_41":11230,"_69":68},[146],[577],{},"Impact:",{"_35":2580,"_37":11233,"_39":1915,"_41":11234,"_65":11235,"_67":11240,"_69":68},"Oif5bAm2",{"_2582":239},[11236],{"_35":2722,"_2607":11237,"_2610":11238,"_41":11239,"_69":68},[172],[4810],{},"2. Suboptimal React Query Configuration",{"_31":11242,"_33":11379},[11243,11258,11269,11368],{"_31":11244,"_33":11245},[],{"_35":2509,"_37":11246,"_39":1915,"_41":11247,"_65":11248,"_67":11257,"_69":68},"IW8jXkOT",{},[11249,11253],{"_35":2722,"_2607":11250,"_2610":11251,"_41":11252,"_69":68},[146,4810],[1257,485],{},{"_35":2483,"_2607":11254,"_2610":11255,"_41":11256,"_69":68},[577],[5946],{},"File: frontend/apps/web/app/loaders.ts Lines: 381-419",{"_31":11259,"_33":11260},[],{"_35":2509,"_37":11261,"_39":1915,"_41":11262,"_65":11263,"_67":11268,"_69":68},"yqXnz7Q7",{},[11264],{"_35":2722,"_2607":11265,"_2610":11266,"_41":11267,"_69":68},[146],[740],{},"Issue: All prefetches block shell render, including non-critical data",{"_31":11270,"_33":11359},[11271,11282,11293,11304,11315,11326,11337,11348],{"_31":11272,"_33":11273},[],{"_35":2509,"_37":11274,"_39":1915,"_41":11275,"_65":11276,"_67":11281,"_69":68},"N54B9GGL",{},[11277],{"_35":2483,"_2607":11278,"_2610":11279,"_41":11280,"_69":68},[1038],[4855],{},"✅ getAuthors (critical - needed for metadata)",{"_31":11283,"_33":11284},[],{"_35":2509,"_37":11285,"_39":1915,"_41":11286,"_65":11287,"_67":11292,"_69":68},"gS9Pi66Y",{},[11288],{"_35":2483,"_2607":11289,"_2610":11290,"_41":11291,"_69":68},[172],[4808],{},"⚠️ getEmbeddedDocs (non-critical - can defer)",{"_31":11294,"_33":11295},[],{"_35":2509,"_37":11296,"_39":1915,"_41":11297,"_65":11298,"_67":11303,"_69":68},"kQIbVfrS",{},[11299],{"_35":2483,"_2607":11300,"_2610":11301,"_41":11302,"_69":68},[1038],[5932],{},"✅ getHomeAndDirectories (critical - needed for navigation)",{"_31":11305,"_33":11306},[],{"_35":2509,"_37":11307,"_39":1915,"_41":11308,"_65":11309,"_67":11314,"_69":68},"3h1PAkTp",{},[11310],{"_35":2483,"_2607":11311,"_2610":11312,"_41":11313,"_69":68},[172],[1335],{},"⚠️ prefetchQueryBlocks (non-critical - can defer)",{"_31":11316,"_33":11317},[],{"_35":2509,"_37":11318,"_39":1915,"_41":11319,"_65":11320,"_67":11325,"_69":68},"vP6r9Ebg",{},[11321],{"_35":2483,"_2607":11322,"_2610":11323,"_41":11324,"_69":68},[1038],[1111],{},"✅ getBreadcrumbs (critical - needed for UI)",{"_31":11327,"_33":11328},[],{"_35":2509,"_37":11329,"_39":1915,"_41":11330,"_65":11331,"_67":11336,"_69":68},"wObWDct8",{},[11332],{"_35":2483,"_2607":11333,"_2610":11334,"_41":11335,"_69":68},[172],[5454],{},"⚠️ queryInteractionSummary (non-critical - comment counts)",{"_31":11338,"_33":11339},[],{"_35":2509,"_37":11340,"_39":1915,"_41":11341,"_65":11342,"_67":11347,"_69":68},"ANAUWdq7",{},[11343],{"_35":2483,"_2607":11344,"_2610":11345,"_41":11346,"_69":68},[172],[5932],{},"⚠️ prefetchEmbeddedDocs (non-critical - can defer)",{"_31":11349,"_33":11350},[],{"_35":2509,"_37":11351,"_39":1915,"_41":11352,"_65":11353,"_67":11358,"_69":68},"d0UomZJN",{},[11354],{"_35":2483,"_2607":11355,"_2610":11356,"_41":11357,"_69":68},[172],[309],{},"⚠️ prefetchAccounts (non-critical - can defer)",{"_35":2509,"_37":11360,"_39":1915,"_41":11361,"_65":11362,"_67":11367,"_69":68},"HI51yJXf",{"_2582":2878},[11363],{"_35":2722,"_2607":11364,"_2610":11365,"_41":11366,"_69":68},[146],[5934],{},"Current Blocking Operations:",{"_31":11369,"_33":11370},[],{"_35":2509,"_37":11371,"_39":1915,"_41":11372,"_65":11373,"_67":11378,"_69":68},"cGK3r0-h",{},[11374],{"_35":2722,"_2607":11375,"_2610":11376,"_41":11377,"_69":68},[146],[577],{},"Impact: Server response delayed by ~200-500ms for non-critical data",{"_35":2580,"_37":11380,"_39":1915,"_41":11381,"_65":11382,"_67":11387,"_69":68},"Kttsxs3D",{"_2582":239},[11383],{"_35":2722,"_2607":11384,"_2610":11385,"_41":11386,"_69":68},[172],[6232],{},"3. All Prefetching is Blocking",{"_31":11389,"_33":11459},[11390,11405,11416,11448],{"_31":11391,"_33":11392},[],{"_35":2509,"_37":11393,"_39":1915,"_41":11394,"_65":11395,"_67":11404,"_69":68},"wDQEThHR",{},[11396,11400],{"_35":2722,"_2607":11397,"_2610":11398,"_41":11399,"_69":68},[146],[1257],{},{"_35":2483,"_2607":11401,"_2610":11402,"_41":11403,"_69":68},[577],[5146],{},"File: frontend/apps/web/app/routes/$.tsx",{"_31":11406,"_33":11407},[],{"_35":2509,"_37":11408,"_39":1915,"_41":11409,"_65":11410,"_67":11415,"_69":68},"f5uzS725",{},[11411],{"_35":2722,"_2607":11412,"_2610":11413,"_41":11414,"_69":68},[146],[740],{},"Issue: All loader data blocks initial response",{"_31":11417,"_33":11439},[11418,11425,11432],{"_31":11419,"_33":11420},[],{"_35":2509,"_37":11421,"_39":1915,"_41":11422,"_65":11423,"_67":11424,"_69":68},"23DWokoW",{},[],"Interaction summaries (comments, likes)",{"_31":11426,"_33":11427},[],{"_35":2509,"_37":11428,"_39":1915,"_41":11429,"_65":11430,"_67":11431,"_69":68},"JeVdzAGP",{},[],"Embedded documents",{"_31":11433,"_33":11434},[],{"_35":2509,"_37":11435,"_39":1915,"_41":11436,"_65":11437,"_67":11438,"_69":68},"Kit2Prfa",{},[],"Query block results",{"_35":2509,"_37":11440,"_39":1915,"_41":11441,"_65":11442,"_67":11447,"_69":68},"O40I_xpN",{"_2582":2583},[11443],{"_35":2722,"_2607":11444,"_2610":11445,"_41":11446,"_69":68},[146],[3821],{},"Opportunity: Stream non-critical data after shell renders",{"_31":11449,"_33":11450},[],{"_35":2509,"_37":11451,"_39":1915,"_41":11452,"_65":11453,"_67":11458,"_69":68},"yRHmkHVE",{},[11454],{"_35":2722,"_2607":11455,"_2610":11456,"_41":11457,"_69":68},[146],[1421],{},"Complexity: Requires UI changes for Suspense/Await boundaries",{"_35":2580,"_37":11460,"_39":1915,"_41":11461,"_65":11462,"_67":11467,"_69":68},"ktYFIkbE",{"_2582":239},[11463],{"_35":2722,"_2607":11464,"_2610":11465,"_41":11466,"_69":68},[172],[309],{},"4. No defer() Usage",{"_35":2580,"_37":11469,"_39":1915,"_41":11470,"_65":11471,"_67":11472,"_69":68},"Ah3meE-f",{"_2582":239},[],"Current Performance Bottlenecks",{"_35":2580,"_37":11474,"_39":1915,"_41":11475,"_65":11476,"_67":11477,"_69":68},"JFVGIiGQ",{"_2582":239},[],"Phase 2: Performance Optimizations",{"_31":11479,"_33":11864},[11480,11531,11669,11752],{"_31":11481,"_33":11526},[11482,11497,11508,11515],{"_31":11483,"_33":11484},[],{"_35":2509,"_37":11485,"_39":1915,"_41":11486,"_65":11487,"_67":11496,"_69":68},"YjvYrugU",{},[11488,11492],{"_35":2722,"_2607":11489,"_2610":11490,"_41":11491,"_69":68},[146,4337],[1257,8503],{},{"_35":2483,"_2607":11493,"_2610":11494,"_41":11495,"_69":68},[577],[2883],{},"File: frontend/apps/web/app/root.tsx Lines to modify: 29-36",{"_31":11498,"_33":11499},[],{"_35":2509,"_37":11500,"_39":1915,"_41":11501,"_65":11502,"_67":11507,"_69":68},"9N5Q1ur6",{},[11503],{"_35":2722,"_2607":11504,"_2610":11505,"_41":11506,"_69":68},[146],[840],{},"Implementation:",{"_31":11509,"_33":11510},[],{"_35":2483,"_37":11511,"_39":1915,"_41":11512,"_65":11513,"_67":11514,"_69":68},"QZ-Ti1IK",{"_2486":11038},[],"export const links: LinksFunction = () => {\n // Get environment variables injected by loader\n const daemonUrl =\n typeof window !== 'undefined'\n ? window.ENV?.SEED_ASSET_HOST || 'http://localhost:56001'\n : 'http://localhost:56001'\n\n const lightningUrl =\n typeof window !== 'undefined'\n ? window.ENV?.LIGHTNING_API_URL || 'https://ln.seed.hyper.media'\n : 'https://ln.seed.hyper.media'\n\n return [\n // Resource hints - CRITICAL for performance\n {rel: 'preconnect', href: daemonUrl, crossOrigin: 'anonymous'},\n {rel: 'dns-prefetch', href: lightningUrl},\n\n // Existing stylesheets\n {rel: 'stylesheet', href: globalStyles},\n {rel: 'stylesheet', href: localTailwindStyles},\n {rel: 'stylesheet', href: sonnerStyles},\n {rel: 'stylesheet', href: slashMenuStyles},\n ]\n}\n",{"_31":11516,"_33":11517},[],{"_35":2509,"_37":11518,"_39":1915,"_41":11519,"_65":11520,"_67":11525,"_69":68},"ewjE6_JL",{},[11521],{"_35":2722,"_2607":11522,"_2610":11523,"_41":11524,"_69":68},[146],[2357],{},"Expected improvement: 100-300ms faster first request to each origin",{"_35":2580,"_37":11527,"_39":1915,"_41":11528,"_65":11529,"_67":11530,"_69":68},"mpmqKQUV",{"_2582":239},[],"Priority 1: Add Resource Hints (HIGH IMPACT, LOW EFFORT)",{"_31":11532,"_33":11664},[11533,11548,11559,11598,11636,11646,11653],{"_31":11534,"_33":11535},[],{"_35":2509,"_37":11536,"_39":1915,"_41":11537,"_65":11538,"_67":11547,"_69":68},"9E3MGmKf",{},[11539,11543],{"_35":2722,"_2607":11540,"_2610":11541,"_41":11542,"_69":68},[146,4810],[1257,4712],{},{"_35":2483,"_2607":11544,"_2610":11545,"_41":11546,"_69":68},[577],[5946],{},"File: frontend/apps/web/app/loaders.ts Lines to modify: 381-419",{"_31":11549,"_33":11550},[],{"_35":2509,"_37":11551,"_39":1915,"_41":11552,"_65":11553,"_67":11558,"_69":68},"PB2jgq86",{},[11554],{"_35":2722,"_2607":11555,"_2610":11556,"_41":11557,"_69":68},[146],[985],{},"Strategy: Separate blocking vs non-blocking prefetches",{"_31":11560,"_33":11589},[11561,11568,11575,11582],{"_31":11562,"_33":11563},[],{"_35":2509,"_37":11564,"_39":1915,"_41":11565,"_65":11566,"_67":11567,"_69":68},"hZaVAN9n",{},[],"Home document",{"_31":11569,"_33":11570},[],{"_35":2509,"_37":11571,"_39":1915,"_41":11572,"_65":11573,"_67":11574,"_69":68},"RYDpSd_Q",{},[],"Home directory (for navigation)",{"_31":11576,"_33":11577},[],{"_35":2509,"_37":11578,"_39":1915,"_41":11579,"_65":11580,"_67":11581,"_69":68},"5uRT-kXJ",{},[],"Document directory (for children)",{"_31":11583,"_33":11584},[],{"_35":2509,"_37":11585,"_39":1915,"_41":11586,"_65":11587,"_67":11588,"_69":68},"M5UAaScs",{},[],"Authors",{"_35":2509,"_37":11590,"_39":1915,"_41":11591,"_65":11592,"_67":11597,"_69":68},"nux9PDwm",{"_2582":2583},[11593],{"_35":2722,"_2607":11594,"_2610":11595,"_41":11596,"_69":68},[146],[5146],{},"Critical (must complete before response):",{"_31":11599,"_33":11627},[11600,11607,11613,11620],{"_31":11601,"_33":11602},[],{"_35":2509,"_37":11603,"_39":1915,"_41":11604,"_65":11605,"_67":11606,"_69":68},"NCA040qC",{},[],"Interaction summaries",{"_31":11608,"_33":11609},[],{"_35":2509,"_37":11610,"_39":1915,"_41":11611,"_65":11612,"_67":11431,"_69":68},"XYSepg9W",{},[],{"_31":11614,"_33":11615},[],{"_35":2509,"_37":11616,"_39":1915,"_41":11617,"_65":11618,"_67":11619,"_69":68},"DL2-Eqgs",{},[],"Query results",{"_31":11621,"_33":11622},[],{"_35":2509,"_37":11623,"_39":1915,"_41":11624,"_65":11625,"_67":11626,"_69":68},"OPE35GOt",{},[],"Account metadata",{"_35":2509,"_37":11628,"_39":1915,"_41":11629,"_65":11630,"_67":11635,"_69":68},"DWq3_ZnM",{"_2582":2583},[11631],{"_35":2722,"_2607":11632,"_2610":11633,"_41":11634,"_69":68},[146],[4688],{},"Non-Critical (can fail gracefully):",{"_31":11637,"_33":11638},[],{"_35":2509,"_37":11639,"_39":1915,"_41":11640,"_65":11641,"_67":11507,"_69":68},"IiZuqHjl",{},[11642],{"_35":2722,"_2607":11643,"_2610":11644,"_41":11645,"_69":68},[146],[840],{},{"_31":11647,"_33":11648},[],{"_35":2483,"_37":11649,"_39":1915,"_41":11650,"_65":11651,"_67":11652,"_69":68},"yV2PrmEw",{"_2486":11038},[],"// Prefetch CRITICAL data - must succeed\nawait instrument(ctx || noopCtx, 'prefetchCriticalData', async () => {\n await Promise.all([\n prefetchCtx.queryClient.prefetchQuery(queryResource(client, homeId)),\n prefetchCtx.queryClient.prefetchQuery(\n queryDirectory(client, homeId, 'Children'),\n ),\n prefetchCtx.queryClient.prefetchQuery(\n queryDirectory(client, docId, 'Children'),\n ),\n ])\n})\n\n// Prefetch NON-CRITICAL data - use allSettled for graceful degradation\nawait instrument(ctx || noopCtx, 'prefetchNonCriticalData', async () => {\n await Promise.allSettled([\n // Interaction summary - nice to have but not blocking\n prefetchCtx.queryClient.prefetchQuery(\n queryInteractionSummary(client, docId),\n ),\n // Embedded docs - will load on client if missing\n ...embeddedDocs.map((doc) =>\n prefetchCtx.queryClient.prefetchQuery(queryResource(client, doc.id)),\n ),\n // Account metadata - will load on client if missing\n ...authors.map((author) =>\n prefetchCtx.queryClient.prefetchQuery(\n queryAccount(client, author.id.uid),\n ),\n ),\n ])\n})\n",{"_31":11654,"_33":11655},[],{"_35":2509,"_37":11656,"_39":1915,"_41":11657,"_65":11658,"_67":11663,"_69":68},"WtFfBuZf",{},[11659],{"_35":2722,"_2607":11660,"_2610":11661,"_41":11662,"_69":68},[146],[2357],{},"Expected improvement: 200-500ms faster TTFB (Time To First Byte)",{"_35":2580,"_37":11665,"_39":1915,"_41":11666,"_65":11667,"_67":11668,"_69":68},"31p5-uvB",{"_2582":239},[],"Priority 2: Split Critical vs Non-Critical Prefetching (HIGH IMPACT, MEDIUM EFFORT)",{"_31":11670,"_33":11747},[11671,11686,11697,11704,11736],{"_31":11672,"_33":11673},[],{"_35":2509,"_37":11674,"_39":1915,"_41":11675,"_65":11676,"_67":11685,"_69":68},"7GMviTqC",{},[11677,11681],{"_35":2722,"_2607":11678,"_2610":11679,"_41":11680,"_69":68},[146,711],[1257,5964],{},{"_35":2483,"_2607":11682,"_2610":11683,"_41":11684,"_69":68},[577],[5986],{},"File: frontend/apps/web/app/providers.tsx Lines to modify: 38-49",{"_31":11687,"_33":11688},[],{"_35":2509,"_37":11689,"_39":1915,"_41":11690,"_65":11691,"_67":11696,"_69":68},"pMT54rgL",{},[11692],{"_35":2722,"_2607":11693,"_2610":11694,"_41":11695,"_69":68},[146],[577],{},"Change:",{"_31":11698,"_33":11699},[],{"_35":2483,"_37":11700,"_39":1915,"_41":11701,"_65":11702,"_67":11703,"_69":68},"l8LubfIu",{"_2486":11038},[],"function createQueryClient() {\n return new QueryClient({\n defaultOptions: {\n queries: {\n staleTime: 60000, // 1 minute (was Infinity)\n refetchOnMount: false,\n refetchOnWindowFocus: false,\n refetchOnReconnect: false,\n },\n },\n })\n}\n",{"_31":11705,"_33":11727},[11706,11713,11720],{"_31":11707,"_33":11708},[],{"_35":2509,"_37":11709,"_39":1915,"_41":11710,"_65":11711,"_67":11712,"_69":68},"av06yEfd",{},[],"Keeps SSR cache benefits (no refetch on mount/focus)",{"_31":11714,"_33":11715},[],{"_35":2509,"_37":11716,"_39":1915,"_41":11717,"_65":11718,"_67":11719,"_69":68},"oVJadrRl",{},[],"Allows background freshness checks after 1 minute",{"_31":11721,"_33":11722},[],{"_35":2509,"_37":11723,"_39":1915,"_41":11724,"_65":11725,"_67":11726,"_69":68},"h07I49sT",{},[],"Balances performance with data freshness",{"_35":2509,"_37":11728,"_39":1915,"_41":11729,"_65":11730,"_67":11735,"_69":68},"U1pLIQEV",{"_2582":2583},[11731],{"_35":2722,"_2607":11732,"_2610":11733,"_41":11734,"_69":68},[146],[1365],{},"Rationale:",{"_31":11737,"_33":11738},[],{"_35":2509,"_37":11739,"_39":1915,"_41":11740,"_65":11741,"_67":11746,"_69":68},"eVLi4PxC",{},[11742],{"_35":2722,"_2607":11743,"_2610":11744,"_41":11745,"_69":68},[146],[2357],{},"Expected improvement: Better long-session UX, minimal performance impact",{"_35":2580,"_37":11748,"_39":1915,"_41":11749,"_65":11750,"_67":11751,"_69":68},"SH6oWMzY",{"_2582":239},[],"Priority 3: Tune React Query staleTime (LOW IMPACT, LOW EFFORT)",{"_31":11753,"_33":11859},[11754,11769,11780,11790,11797,11837,11848],{"_31":11755,"_33":11756},[],{"_35":2509,"_37":11757,"_39":1915,"_41":11758,"_65":11759,"_67":11768,"_69":68},"bfQzKbaG",{},[11760,11764],{"_35":2722,"_2607":11761,"_2610":11762,"_41":11763,"_69":68},[146,5986],[1257,6573],{},{"_35":2483,"_2607":11765,"_2610":11766,"_41":11767,"_69":68},[577],[5146],{},"File: frontend/apps/web/app/routes/$.tsx Lines to modify: 155-236",{"_31":11770,"_33":11771},[],{"_35":2509,"_37":11772,"_39":1915,"_41":11773,"_65":11774,"_67":11779,"_69":68},"_U34UkGL",{},[11775],{"_35":2722,"_2607":11776,"_2610":11777,"_41":11778,"_69":68},[146],[985],{},"Strategy: Split loader into critical shell data + deferred streaming data",{"_31":11781,"_33":11782},[],{"_35":2509,"_37":11783,"_39":1915,"_41":11784,"_65":11785,"_67":11507,"_69":68},"FwgjJRLf",{},[11786],{"_35":2722,"_2607":11787,"_2610":11788,"_41":11789,"_69":68},[146],[840],{},{"_31":11791,"_33":11792},[],{"_35":2483,"_37":11793,"_39":1915,"_41":11794,"_65":11795,"_67":11796,"_69":68},"WMVFvaEt",{"_2486":11038},[],"import {defer} from '@remix-run/node'\n\nexport const loader = async ({params, request}) => {\n const parsedRequest = parseRequest(request)\n const documentId = unpackHmId(params['*'])\n\n if (!useFullRender(parsedRequest)) {\n return null\n }\n\n const serviceConfig = await getConfig(hostname)\n\n // Load CRITICAL data (blocks shell render)\n const criticalData = await loadCriticalSiteResource(parsedRequest, documentId)\n\n // Start loading NON-CRITICAL data (streams after shell)\n const deferredData = {\n interactionSummary: loadInteractionSummary(documentId),\n embeddedDocs: loadEmbeddedDocuments(documentId),\n }\n\n return defer({\n ...criticalData,\n ...deferredData,\n })\n}\n",{"_31":11798,"_33":11828},[11799,11810,11821],{"_31":11800,"_33":11801},[],{"_35":2509,"_37":11802,"_39":1915,"_41":11803,"_65":11804,"_67":11809,"_69":68},"msDBbPCc",{},[11805],{"_35":2483,"_2607":11806,"_2610":11807,"_41":11808,"_69":68},[2609],[711],{},"Wrap non-critical components in ",{"_31":11811,"_33":11812},[],{"_35":2509,"_37":11813,"_39":1915,"_41":11814,"_65":11815,"_67":11820,"_69":68},"jSUWE5h6",{},[11816],{"_35":2483,"_2607":11817,"_2610":11818,"_41":11819,"_69":68},[1257],[3821],{},"Use component for deferred data",{"_31":11822,"_33":11823},[],{"_35":2509,"_37":11824,"_39":1915,"_41":11825,"_65":11826,"_67":11827,"_69":68},"y1fOFGw8",{},[],"Add loading states for streaming sections",{"_35":2509,"_37":11829,"_39":1915,"_41":11830,"_65":11831,"_67":11836,"_69":68},"A5gD_YuB",{"_2582":2583},[11832],{"_35":2722,"_2607":11833,"_2610":11834,"_41":11835,"_69":68},[146],[309],{},"UI Changes Required:",{"_31":11838,"_33":11839},[],{"_35":2509,"_37":11840,"_39":1915,"_41":11841,"_65":11842,"_67":11847,"_69":68},"Mrt9vw2U",{},[11843],{"_35":2722,"_2607":11844,"_2610":11845,"_41":11846,"_69":68},[146],[2357],{},"Expected improvement: 300-600ms faster perceived load time",{"_31":11849,"_33":11850},[],{"_35":2509,"_37":11851,"_39":1915,"_41":11852,"_65":11853,"_67":11858,"_69":68},"-_Q1T0L9",{},[11854],{"_35":2722,"_2607":11855,"_2610":11856,"_41":11857,"_69":68},[146],[1257],{},"Note: This is the most complex change and should be considered for a future iteration if simpler optimizations don't provide sufficient gains.",{"_35":2580,"_37":11860,"_39":1915,"_41":11861,"_65":11862,"_67":11863,"_69":68},"1CRWZ_d5",{"_2582":239},[],"Priority 4: Implement defer() for Streaming (MEDIUM IMPACT, HIGH EFFORT)",{"_35":2580,"_37":11865,"_39":1915,"_41":11866,"_65":11867,"_67":11868,"_69":68},"Ql8XVDc-",{"_2582":239},[],"Optimization Roadmap",{"_31":11870,"_33":12235},[11871,12081],{"_31":11872,"_33":12076},[11873,11923,11980,12023],{"_31":11874,"_33":11914},[11875,11886,11893,11900,11907],{"_31":11876,"_33":11877},[],{"_35":2509,"_37":11878,"_39":1915,"_41":11879,"_65":11880,"_67":11885,"_69":68},"2V5SWRz9",{},[11881],{"_35":2483,"_2607":11882,"_2610":11883,"_41":11884,"_69":68},[3821],[5986],{},"[ ] Update frontend/apps/web/app/root.tsx links export",{"_31":11887,"_33":11888},[],{"_35":2509,"_37":11889,"_39":1915,"_41":11890,"_65":11891,"_67":11892,"_69":68},"2nSkSpE7",{},[],"[ ] Add preconnect for DAEMON_HTTP_URL/SEED_ASSET_HOST",{"_31":11894,"_33":11895},[],{"_35":2509,"_37":11896,"_39":1915,"_41":11897,"_65":11898,"_67":11899,"_69":68},"NC5UhmFp",{},[],"[ ] Add dns-prefetch for LIGHTNING_API_URL",{"_31":11901,"_33":11902},[],{"_35":2509,"_37":11903,"_39":1915,"_41":11904,"_65":11905,"_67":11906,"_69":68},"C4ti85z_",{},[],"[ ] Add dns-prefetch for NOTIFY_SERVICE_HOST (if configured)",{"_31":11908,"_33":11909},[],{"_35":2509,"_37":11910,"_39":1915,"_41":11911,"_65":11912,"_67":11913,"_69":68},"aQffYhyK",{},[],"[ ] Test in production mode (resource hints only work in production)",{"_35":2509,"_37":11915,"_39":1915,"_41":11916,"_65":11917,"_67":11922,"_69":68},"vReQTOY1",{"_2582":2583},[11918],{"_35":2722,"_2607":11919,"_2610":11920,"_41":11921,"_69":68},[1257],[1335],{},"[ ] Add Resource Hints",{"_31":11924,"_33":11971},[11925,11936,11943,11950,11957,11964],{"_31":11926,"_33":11927},[],{"_35":2509,"_37":11928,"_39":1915,"_41":11929,"_65":11930,"_67":11935,"_69":68},"Z7txlWgJ",{},[11931],{"_35":2483,"_2607":11932,"_2610":11933,"_41":11934,"_69":68},[3821],[4856],{},"[ ] Update frontend/apps/web/app/loaders.ts prefetch logic",{"_31":11937,"_33":11938},[],{"_35":2509,"_37":11939,"_39":1915,"_41":11940,"_65":11941,"_67":11942,"_69":68},"S0AH1gFz",{},[],"[ ] Separate critical Promise.all from non-critical Promise.allSettled",{"_31":11944,"_33":11945},[],{"_35":2509,"_37":11946,"_39":1915,"_41":11947,"_65":11948,"_67":11949,"_69":68},"rKWXUq92",{},[],"[ ] Move interaction summary to non-critical section",{"_31":11951,"_33":11952},[],{"_35":2509,"_37":11953,"_39":1915,"_41":11954,"_65":11955,"_67":11956,"_69":68},"lDtv4-gq",{},[],"[ ] Move embedded docs to non-critical section",{"_31":11958,"_33":11959},[],{"_35":2509,"_37":11960,"_39":1915,"_41":11961,"_65":11962,"_67":11963,"_69":68},"_4N6vmWt",{},[],"[ ] Move account metadata to non-critical section",{"_31":11965,"_33":11966},[],{"_35":2509,"_37":11967,"_39":1915,"_41":11968,"_65":11969,"_67":11970,"_69":68},"GVtFSSX9",{},[],"[ ] Add instrumentation tags for monitoring",{"_35":2509,"_37":11972,"_39":1915,"_41":11973,"_65":11974,"_67":11979,"_69":68},"LF9wNJR-",{"_2582":2583},[11975],{"_35":2722,"_2607":11976,"_2610":11977,"_41":11978,"_69":68},[1257],[4797],{},"[ ] Split Prefetching",{"_31":11981,"_33":12014},[11982,11993,12000,12007],{"_31":11983,"_33":11984},[],{"_35":2509,"_37":11985,"_39":1915,"_41":11986,"_65":11987,"_67":11992,"_69":68},"csWOBpUm",{},[11988],{"_35":2483,"_2607":11989,"_2610":11990,"_41":11991,"_69":68},[3821],[4716],{},"[ ] Update frontend/apps/web/app/providers.tsx",{"_31":11994,"_33":11995},[],{"_35":2509,"_37":11996,"_39":1915,"_41":11997,"_65":11998,"_67":11999,"_69":68},"tj-zFGUW",{},[],"[ ] Change staleTime from Infinity to 60000",{"_31":12001,"_33":12002},[],{"_35":2509,"_37":12003,"_39":1915,"_41":12004,"_65":12005,"_67":12006,"_69":68},"M4vK_gOZ",{},[],"[ ] Verify refetch behavior is correct",{"_31":12008,"_33":12009},[],{"_35":2509,"_37":12010,"_39":1915,"_41":12011,"_65":12012,"_67":12013,"_69":68},"4aIUWVlG",{},[],"[ ] Test client-side navigation still uses cache",{"_35":2509,"_37":12015,"_39":1915,"_41":12016,"_65":12017,"_67":12022,"_69":68},"sY9EE4pL",{"_2582":2583},[12018],{"_35":2722,"_2607":12019,"_2610":12020,"_41":12021,"_69":68},[1257],[2357],{},"[ ] Tune React Query",{"_31":12024,"_33":12067},[12025,12032,12039,12046,12053,12060],{"_31":12026,"_33":12027},[],{"_35":2509,"_37":12028,"_39":1915,"_41":12029,"_65":12030,"_67":12031,"_69":68},"62qAvtmk",{},[],"[ ] Create separate loader functions for critical vs deferred",{"_31":12033,"_33":12034},[],{"_35":2509,"_37":12035,"_39":1915,"_41":12036,"_65":12037,"_67":12038,"_69":68},"aowjTQ13",{},[],"[ ] Update route to use defer()",{"_31":12040,"_33":12041},[],{"_35":2509,"_37":12042,"_39":1915,"_41":12043,"_65":12044,"_67":12045,"_69":68},"OCEw3cF6",{},[],"[ ] Add Suspense boundaries in UI",{"_31":12047,"_33":12048},[],{"_35":2509,"_37":12049,"_39":1915,"_41":12050,"_65":12051,"_67":12052,"_69":68},"6wrqNIu5",{},[],"[ ] Add Await components for deferred data",{"_31":12054,"_33":12055},[],{"_35":2509,"_37":12056,"_39":1915,"_41":12057,"_65":12058,"_67":12059,"_69":68},"9E005_ID",{},[],"[ ] Add loading states",{"_31":12061,"_33":12062},[],{"_35":2509,"_37":12063,"_39":1915,"_41":12064,"_65":12065,"_67":12066,"_69":68},"vnvMR73b",{},[],"[ ] Test streaming behavior",{"_35":2509,"_37":12068,"_39":1915,"_41":12069,"_65":12070,"_67":12075,"_69":68},"xL_8csfj",{"_2582":2583},[12071],{"_35":2722,"_2607":12072,"_2610":12073,"_41":12074,"_69":68},[1257],[2609],{},"[ ] (Optional) Implement defer()",{"_35":2580,"_37":12077,"_39":1915,"_41":12078,"_65":12079,"_67":12080,"_69":68},"ZGA4W6tY",{"_2582":2583},[],"Phase 2 Tasks",{"_31":12082,"_33":12230},[12083,12133,12179],{"_31":12084,"_33":12124},[12085,12096,12103,12110,12117],{"_31":12086,"_33":12087},[],{"_35":2509,"_37":12088,"_39":1915,"_41":12089,"_65":12090,"_67":12095,"_69":68},"z2BWVT5y",{},[12091],{"_35":2483,"_2607":12092,"_2610":12093,"_41":12094,"_69":68},[985],[1111],{},"[ ] Run yarn web and verify app loads",{"_31":12097,"_33":12098},[],{"_35":2509,"_37":12099,"_39":1915,"_41":12100,"_65":12101,"_67":12102,"_69":68},"VTjJTHUH",{},[],"[ ] Test pages with Query blocks",{"_31":12104,"_33":12105},[],{"_35":2509,"_37":12106,"_39":1915,"_41":12107,"_65":12108,"_67":12109,"_69":68},"pLiAoU3G",{},[],"[ ] Test client-side navigation",{"_31":12111,"_33":12112},[],{"_35":2509,"_37":12113,"_39":1915,"_41":12114,"_65":12115,"_67":12116,"_69":68},"pX9--qBU",{},[],"[ ] Verify no console errors",{"_31":12118,"_33":12119},[],{"_35":2509,"_37":12120,"_39":1915,"_41":12121,"_65":12122,"_67":12123,"_69":68},"ailcy7ri",{},[],"[ ] Check Network tab for resource hint effects",{"_35":2509,"_37":12125,"_39":1915,"_41":12126,"_65":12127,"_67":12132,"_69":68},"2ScAk36v",{"_2582":2583},[12128],{"_35":2722,"_2607":12129,"_2610":12130,"_41":12131,"_69":68},[1257],[5932],{},"[ ] Development Testing",{"_31":12134,"_33":12170},[12135,12142,12149,12156,12163],{"_31":12136,"_33":12137},[],{"_35":2509,"_37":12138,"_39":1915,"_41":12139,"_65":12140,"_67":12141,"_69":68},"vcLmgXk5",{},[],"[ ] Measure TTFB before/after",{"_31":12143,"_33":12144},[],{"_35":2509,"_37":12145,"_39":1915,"_41":12146,"_65":12147,"_67":12148,"_69":68},"9BHApTtB",{},[],"[ ] Measure FCP (First Contentful Paint)",{"_31":12150,"_33":12151},[],{"_35":2509,"_37":12152,"_39":1915,"_41":12153,"_65":12154,"_67":12155,"_69":68},"rK0xLoPH",{},[],"[ ] Measure LCP (Largest Contentful Paint)",{"_31":12157,"_33":12158},[],{"_35":2509,"_37":12159,"_39":1915,"_41":12160,"_65":12161,"_67":12162,"_69":68},"ohn1JInI",{},[],"[ ] Measure TTI (Time To Interactive)",{"_31":12164,"_33":12165},[],{"_35":2509,"_37":12166,"_39":1915,"_41":12167,"_65":12168,"_67":12169,"_69":68},"QrDgEinM",{},[],"[ ] Test on slow 3G network simulation",{"_35":2509,"_37":12171,"_39":1915,"_41":12172,"_65":12173,"_67":12178,"_69":68},"BKjmI4WQ",{"_2582":2583},[12174],{"_35":2722,"_2607":12175,"_2610":12176,"_41":12177,"_69":68},[1257],[5932],{},"[ ] Performance Testing",{"_31":12180,"_33":12221},[12181,12192,12199,12210],{"_31":12182,"_33":12183},[],{"_35":2509,"_37":12184,"_39":1915,"_41":12185,"_65":12186,"_67":12191,"_69":68},"3P8rJAi6",{},[12187],{"_35":2483,"_2607":12188,"_2610":12189,"_41":12190,"_69":68},[985],[4797],{},"[ ] Run yarn web:test",{"_31":12193,"_33":12194},[],{"_35":2509,"_37":12195,"_39":1915,"_41":12196,"_65":12197,"_67":12198,"_69":68},"OB7T21hN",{},[],"[ ] Verify all tests pass",{"_31":12200,"_33":12201},[],{"_35":2509,"_37":12202,"_39":1915,"_41":12203,"_65":12204,"_67":12209,"_69":68},"rTzmcI1e",{},[12205],{"_35":2483,"_2607":12206,"_2610":12207,"_41":12208,"_69":68},[309],[6479],{},"[ ] Run typecheck: yarn typecheck",{"_31":12211,"_33":12212},[],{"_35":2509,"_37":12213,"_39":1915,"_41":12214,"_65":12215,"_67":12220,"_69":68},"OrXdHaCN",{},[12216],{"_35":2483,"_2607":12217,"_2610":12218,"_41":12219,"_69":68},[1335],[4810],{},"[ ] Run format check: yarn format:check",{"_35":2509,"_37":12222,"_39":1915,"_41":12223,"_65":12224,"_67":12229,"_69":68},"P-2GUYnC",{"_2582":2583},[12225],{"_35":2722,"_2607":12226,"_2610":12227,"_41":12228,"_69":68},[1257],[5932],{},"[ ] Integration Testing",{"_35":2580,"_37":12231,"_39":1915,"_41":12232,"_65":12233,"_67":12234,"_69":68},"3rR8eqp8",{"_2582":2583},[],"Testing",{"_35":2580,"_37":12236,"_39":1915,"_41":12237,"_65":12238,"_67":12239,"_69":68},"-0AFA8z1",{"_2582":239},[],"Implementation Checklist",{"_31":12241,"_33":12331},[12242,12274,12306],{"_31":12243,"_33":12269},[12244,12251,12258],{"_31":12245,"_33":12246},[],{"_35":2509,"_37":12247,"_39":1915,"_41":12248,"_65":12249,"_67":12250,"_69":68},"t-CmfyHD",{},[],"Resource hints: -150ms connection overhead",{"_31":12252,"_33":12253},[],{"_35":2509,"_37":12254,"_39":1915,"_41":12255,"_65":12256,"_67":12257,"_69":68},"adUQROK9",{},[],"Split prefetching: -400ms TTFB",{"_31":12259,"_33":12260},[],{"_35":2509,"_37":12261,"_39":1915,"_41":12262,"_65":12263,"_67":12268,"_69":68},"7eOuxHfs",{},[12264],{"_35":2722,"_2607":12265,"_2610":12266,"_41":12267,"_69":68},[1421],[5219],{},"Combined: ~550ms faster first paint",{"_35":2580,"_37":12270,"_39":1915,"_41":12271,"_65":12272,"_67":12273,"_69":68},"DoIYWRXi",{"_2582":2583},[],"Optimistic Scenario",{"_31":12275,"_33":12301},[12276,12283,12290],{"_31":12277,"_33":12278},[],{"_35":2509,"_37":12279,"_39":1915,"_41":12280,"_65":12281,"_67":12282,"_69":68},"Yf1qdYdx",{},[],"Resource hints: -100ms connection overhead",{"_31":12284,"_33":12285},[],{"_35":2509,"_37":12286,"_39":1915,"_41":12287,"_65":12288,"_67":12289,"_69":68},"KEAvBhN3",{},[],"Split prefetching: -200ms TTFB",{"_31":12291,"_33":12292},[],{"_35":2509,"_37":12293,"_39":1915,"_41":12294,"_65":12295,"_67":12300,"_69":68},"aLr-TaB9",{},[12296],{"_35":2722,"_2607":12297,"_2610":12298,"_41":12299,"_69":68},[1421],[5219],{},"Combined: ~300ms faster first paint",{"_35":2580,"_37":12302,"_39":1915,"_41":12303,"_65":12304,"_67":12305,"_69":68},"mR2IBsOR",{"_2582":2583},[],"Conservative Scenario",{"_31":12307,"_33":12326},[12308,12315],{"_31":12309,"_33":12310},[],{"_35":2509,"_37":12311,"_39":1915,"_41":12312,"_65":12313,"_67":12314,"_69":68},"z1GdIaZj",{},[],"Additional: -300ms perceived load time",{"_31":12316,"_33":12317},[],{"_35":2509,"_37":12318,"_39":1915,"_41":12319,"_65":12320,"_67":12325,"_69":68},"z6mNP8zh",{},[12321],{"_35":2722,"_2607":12322,"_2610":12323,"_41":12324,"_69":68},[146],[3886],{},"Total: ~600-850ms improvement",{"_35":2580,"_37":12327,"_39":1915,"_41":12328,"_65":12329,"_67":12330,"_69":68},"UQaqbMMl",{"_2582":2583},[],"With defer() (future)",{"_35":2580,"_37":12332,"_39":1915,"_41":12333,"_65":12334,"_67":12335,"_69":68},"x3lJ3SES",{"_2582":239},[],"Expected Performance Gains",{"_31":12337,"_33":12483},[12338,12448],{"_31":12339,"_33":12443},[12340,12372,12411],{"_31":12341,"_33":12363},[12342,12349,12356],{"_31":12343,"_33":12344},[],{"_35":2509,"_37":12345,"_39":1915,"_41":12346,"_65":12347,"_67":12348,"_69":68},"VEdlvAF9",{},[],"TTFB (Time To First Byte)",{"_31":12350,"_33":12351},[],{"_35":2509,"_37":12352,"_39":1915,"_41":12353,"_65":12354,"_67":12355,"_69":68},"impS9HRb",{},[],"Server processing time",{"_31":12357,"_33":12358},[],{"_35":2509,"_37":12359,"_39":1915,"_41":12360,"_65":12361,"_67":12362,"_69":68},"4XGK3E1r",{},[],"Prefetch operation duration (instrumentation)",{"_35":2509,"_37":12364,"_39":1915,"_41":12365,"_65":12366,"_67":12371,"_69":68},"SJwrf7xA",{"_2582":2583},[12367],{"_35":2722,"_2607":12368,"_2610":12369,"_41":12370,"_69":68},[146],[3821],{},"Server-Side:",{"_31":12373,"_33":12402},[12374,12381,12388,12395],{"_31":12375,"_33":12376},[],{"_35":2509,"_37":12377,"_39":1915,"_41":12378,"_65":12379,"_67":12380,"_69":68},"JiL-Vd_u",{},[],"FCP (First Contentful Paint)",{"_31":12382,"_33":12383},[],{"_35":2509,"_37":12384,"_39":1915,"_41":12385,"_65":12386,"_67":12387,"_69":68},"t1EiUgQa",{},[],"LCP (Largest Contentful Paint)",{"_31":12389,"_33":12390},[],{"_35":2509,"_37":12391,"_39":1915,"_41":12392,"_65":12393,"_67":12394,"_69":68},"ka04v_n9",{},[],"TTI (Time To Interactive)",{"_31":12396,"_33":12397},[],{"_35":2509,"_37":12398,"_39":1915,"_41":12399,"_65":12400,"_67":12401,"_69":68},"7A_wBIaj",{},[],"Total Blocking Time",{"_35":2509,"_37":12403,"_39":1915,"_41":12404,"_65":12405,"_67":12410,"_69":68},"bxralLPr",{"_2582":2583},[12406],{"_35":2722,"_2607":12407,"_2610":12408,"_41":12409,"_69":68},[146],[3821],{},"Client-Side:",{"_31":12412,"_33":12434},[12413,12420,12427],{"_31":12414,"_33":12415},[],{"_35":2509,"_37":12416,"_39":1915,"_41":12417,"_65":12418,"_67":12419,"_69":68},"4TE92j3V",{},[],"Perceived load speed",{"_31":12421,"_33":12422},[],{"_35":2509,"_37":12423,"_39":1915,"_41":12424,"_65":12425,"_67":12426,"_69":68},"a-s62LJP",{},[],"Client-side navigation smoothness",{"_31":12428,"_33":12429},[],{"_35":2509,"_37":12430,"_39":1915,"_41":12431,"_65":12432,"_67":12433,"_69":68},"NczcTdsf",{},[],"Cache hit rates",{"_35":2509,"_37":12435,"_39":1915,"_41":12436,"_65":12437,"_67":12442,"_69":68},"rfmLBgHM",{"_2582":2583},[12438],{"_35":2722,"_2607":12439,"_2610":12440,"_41":12441,"_69":68},[146],[1892],{},"User Experience:",{"_35":2580,"_37":12444,"_39":1915,"_41":12445,"_65":12446,"_67":12447,"_69":68},"xWuFMBxu",{"_2582":239},[],"Metrics to Track",{"_31":12449,"_33":12478},[12450,12457,12464,12471],{"_31":12451,"_33":12452},[],{"_35":2509,"_37":12453,"_39":1915,"_41":12454,"_65":12455,"_67":12456,"_69":68},"oVOGnuzf",{},[],"Chrome DevTools Network/Performance tabs",{"_31":12458,"_33":12459},[],{"_35":2509,"_37":12460,"_39":1915,"_41":12461,"_65":12462,"_67":12463,"_69":68},"6XrmGA8Y",{},[],"Lighthouse CI",{"_31":12465,"_33":12466},[],{"_35":2509,"_37":12467,"_39":1915,"_41":12468,"_65":12469,"_67":12470,"_69":68},"vIX-Mksq",{},[],"WebPageTest",{"_31":12472,"_33":12473},[],{"_35":2509,"_37":12474,"_39":1915,"_41":12475,"_65":12476,"_67":12477,"_69":68},"be8OyeP3",{},[],"Custom instrumentation (already in place)",{"_35":2580,"_37":12479,"_39":1915,"_41":12480,"_65":12481,"_67":12482,"_69":68},"cfCfIbxC",{"_2582":2583},[],"Tools",{"_35":2580,"_37":12484,"_39":1915,"_41":12485,"_65":12486,"_67":12487,"_69":68},"g7DCmvPR",{"_2582":239},[],"Monitoring & Validation",{"_31":12489,"_33":12548},[12490,12541],{"_31":12491,"_33":12536},[12492,12503,12514,12525],{"_31":12493,"_33":12494},[],{"_35":2509,"_37":12495,"_39":1915,"_41":12496,"_65":12497,"_67":12502,"_69":68},"pEYHD9-G",{},[12498],{"_35":2722,"_2607":12499,"_2610":12500,"_41":12501,"_69":68},[146],[840],{},"Resource Hints: Remove from links export (low risk)",{"_31":12504,"_33":12505},[],{"_35":2509,"_37":12506,"_39":1915,"_41":12507,"_65":12508,"_67":12513,"_69":68},"8CLSm82e",{},[12509],{"_35":2722,"_2607":12510,"_2610":12511,"_41":12512,"_69":68},[146],[4715],{},"Split Prefetching: Revert to single Promise.all (medium risk)",{"_31":12515,"_33":12516},[],{"_35":2509,"_37":12517,"_39":1915,"_41":12518,"_65":12519,"_67":12524,"_69":68},"TJ2RA4e2",{},[12520],{"_35":2722,"_2607":12521,"_2610":12522,"_41":12523,"_69":68},[146],[1365],{},"staleTime: Revert to Infinity (low risk)",{"_31":12526,"_33":12527},[],{"_35":2509,"_37":12528,"_39":1915,"_41":12529,"_65":12530,"_67":12535,"_69":68},"9mIyUZZs",{},[12531],{"_35":2722,"_2607":12532,"_2610":12533,"_41":12534,"_69":68},[146],[1306],{},"defer(): Remove defer, return to blocking loader (high risk if implemented)",{"_35":2509,"_37":12537,"_39":1915,"_41":12538,"_65":12539,"_67":12540,"_69":68},"54Ch84Io",{"_2582":2878},[],"If optimizations cause issues:",{"_31":12542,"_33":12543},[],{"_35":2509,"_37":12544,"_39":1915,"_41":12545,"_65":12546,"_67":12547,"_69":68},"QAaHj2on",{},[],"All changes are independent and can be reverted individually.",{"_35":2580,"_37":12549,"_39":1915,"_41":12550,"_65":12551,"_67":12552,"_69":68},"INR3L8PE",{"_2582":239},[],"Rollback Plan",{"_31":12554,"_33":12604},[12555,12568,12580,12592],{"_31":12556,"_33":12557},[],{"_35":2509,"_37":12558,"_39":1915,"_41":12559,"_65":12560,"_67":12567,"_69":68},"__XrSbmi",{},[12561],{"_35":206,"_2607":12562,"_2610":12563,"_41":12565,"_69":12566},[2357],[12564],67,{},"https://remix.run/docs/en/main/guides/streaming","Remix defer() docs: https://remix.run/docs/en/main/guides/streaming",{"_31":12569,"_33":12570},[],{"_35":2509,"_37":12571,"_39":1915,"_41":12572,"_65":12573,"_67":12579,"_69":68},"FdZYmD3O",{},[12574],{"_35":206,"_2607":12575,"_2610":12576,"_41":12577,"_69":12578},[4715],[9880],{},"https://tanstack.com/query/latest/docs/react/guides/ssr","React Query SSR: https://tanstack.com/query/latest/docs/react/guides/ssr",{"_31":12581,"_33":12582},[],{"_35":2509,"_37":12583,"_39":1915,"_41":12584,"_65":12585,"_67":12591,"_69":68},"QXSiv8QL",{},[12586],{"_35":206,"_2607":12587,"_2610":12588,"_41":12589,"_69":12590},[1111],[5962],{},"https://www.w3.org/TR/resource-hints/","Resource Hints: https://www.w3.org/TR/resource-hints/",{"_31":12593,"_33":12594},[],{"_35":2509,"_37":12595,"_39":1915,"_41":12596,"_65":12597,"_67":12603,"_69":68},"eooFPVc8",{},[12598],{"_35":206,"_2607":12599,"_2610":12600,"_41":12601,"_69":12602},[4715],[5146],{},"https://web.dev/vitals/","Core Web Vitals: https://web.dev/vitals/",{"_35":2580,"_37":12605,"_39":1915,"_41":12606,"_65":12607,"_67":12608,"_69":68},"DLYgmDHb",{"_2582":2583},[],"References",[78],"/tech-talks/ssr-performance-optimization-plan","2025-12-19T13:27:08.495Z",{"_86":1928,"_88":1929},{},{"_92":1915,"_96":1926},{"_37":1902,"_104":53,"_54":12616,"_70":1905,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,1904],1778632074486,[158,1902,1905,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/ssr-performance-optimization-plan\",\"bafy2bzacedf5krbv3qsoly6f2t65bu5dmpsoepkkhiy5xcvcoclezzmu7sqdm\",true]",{"_119":12621,"_156":13101,"_159":13102},{"_121":12622,"_141":44,"_142":13100,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":12623,"_37":13098},{"_28":12624,"_70":1935,"_71":53,"_72":13092,"_54":13093,"_80":1944,"_82":13094,"_84":13095,"_90":13096,"_92":1945,"_94":13097,"_98":99},[12625,12635,12677,12733],{"_31":12626,"_33":12627},[],{"_35":2509,"_37":12628,"_39":1935,"_41":12629,"_65":12630,"_67":1955,"_69":68},"QUzEBqra",{},[12631],{"_35":206,"_2607":12632,"_2610":12633,"_41":12634,"_69":1955},[146],[5733],{},{"_31":12636,"_33":12672},[12637,12644,12658],{"_31":12638,"_33":12639},[],{"_35":2509,"_37":12640,"_39":1945,"_41":12641,"_65":12642,"_67":12643,"_69":68},"Z1hw-uMI",{},[],"Currently, the server rendering is implemented in a very messy way, and in many cases it is just broken because we opted to simplify the code.",{"_31":12645,"_33":12653},[12646],{"_31":12647,"_33":12648},[],{"_35":2509,"_37":12649,"_39":1945,"_41":12650,"_65":12651,"_67":12652,"_69":68},"plLkJZBB",{},[],"todo: describe the situation on the web profile page when the name and photo is mutated.",{"_35":2580,"_37":12654,"_39":1945,"_41":12655,"_65":12656,"_67":12657,"_69":68},"9eu9oyZg",{"_2582":239},[],"When the client mutates a Resource that was server-rendered",{"_31":12659,"_33":12667},[12660],{"_31":12661,"_33":12662},[],{"_35":2509,"_37":12663,"_39":1945,"_41":12664,"_65":12665,"_67":12666,"_69":68},"e4WMuQWm",{},[],"todo: describe this mess",{"_35":2580,"_37":12668,"_39":1945,"_41":12669,"_65":12670,"_67":12671,"_69":68},"8CPXOMdj",{"_2582":239},[],"supportQueries and supportDocuments",{"_35":2580,"_37":12673,"_39":1945,"_41":12674,"_65":12675,"_67":12676,"_69":68},"Tzht2p5Q",{"_2582":239},[],"Current Pattern",{"_31":12678,"_33":12728},[12679,12686,12693],{"_31":12680,"_33":12681},[],{"_35":2509,"_37":12682,"_39":1945,"_41":12683,"_65":12684,"_67":12685,"_69":68},"wOClFZXP",{},[],"In the server render, we will explicitly decide what data to load, and pre-fill a ReactQuery cache. Every page will serialize the cache and pre-fill it in the same way.",{"_31":12687,"_33":12688},[],{"_35":2509,"_37":12689,"_39":1945,"_41":12690,"_65":12691,"_67":12692,"_69":68},"eGG7IRfI",{},[],"Now, the components inside the page can simply call the RQ hooks in the same way every time. In the server it will use the pre-filled cache. On the client's first render, it will use the cache that was passed down from the server",{"_31":12694,"_33":12723},[12695,12702,12709,12716],{"_31":12696,"_33":12697},[],{"_35":2509,"_37":12698,"_39":1945,"_41":12699,"_65":12700,"_67":12701,"_69":68},"exGHyI8M",{},[],"This means our components can be much simpler, because we will not need to explicitly hand down the server data through props and use some conflict resolution to decide when to use that compared to the RQ hooks. The code will be shorter, more consistent with desktop data loading code, and less buggy.",{"_31":12703,"_33":12704},[],{"_35":2509,"_37":12705,"_39":1945,"_41":12706,"_65":12707,"_67":12708,"_69":68},"7JZAk0x5",{},[],"If the server does not preload something, the client will load the data async using RQ when it wakes up.",{"_31":12710,"_33":12711},[],{"_35":2509,"_37":12712,"_39":1945,"_41":12713,"_65":12714,"_67":12715,"_69":68},"h7rxXW97",{},[],"If you decide that some more data should be loaded on the server, you can just add it to the server cache fill, without changing any client components.",{"_31":12717,"_33":12718},[],{"_35":2509,"_37":12719,"_39":1945,"_41":12720,"_65":12721,"_67":12722,"_69":68},"f-ZCjqbf",{},[],"This will avoid the confusing \"supportQueries\" and \"supportDocuments\" code which is very unpleasant to work with and has caused a lot of confusion on our team. This code was initially added to support server rendering, and the proposed pattern accomplishes the same thing in a less confusing way.",{"_35":2580,"_37":12724,"_39":1945,"_41":12725,"_65":12726,"_67":12727,"_69":68},"A7TT0XpG",{"_2582":239},[],"Benefit",{"_35":2580,"_37":12729,"_39":1945,"_41":12730,"_65":12731,"_67":12732,"_69":68},"DhqW8tub",{"_2582":239},[],"Proposed Solution",{"_31":12734,"_33":13087},[12735,12854,12861,12868,12875,12886,12893,12922,12955,12962,12969,12980,12987,12998,13072],{"_31":12736,"_33":12849},[12737,12786],{"_31":12738,"_33":12777},[12739,12750,12761],{"_31":12740,"_33":12741},[],{"_35":2509,"_37":12742,"_39":1945,"_41":12743,"_65":12744,"_67":12749,"_69":68},"eD_vnL8U",{},[12745],{"_35":2483,"_2607":12746,"_2610":12747,"_41":12748,"_69":68},[1365],[2357],{},"Create a QueryClient.",{"_31":12751,"_33":12752},[],{"_35":2509,"_37":12753,"_39":1945,"_41":12754,"_65":12755,"_67":12760,"_69":68},"I7A1XA9t",{},[12756],{"_35":2483,"_2607":12757,"_2610":12758,"_41":12759,"_69":68},[146,4715],[4700,5946],{},"prefetchQuery(or prefetchInfiniteQuery) for whatever you want ready.",{"_31":12762,"_33":12763},[],{"_35":2509,"_37":12764,"_39":1945,"_41":12765,"_65":12766,"_67":12776,"_69":68},"RdQGvJyX",{},[12767,12771],{"_35":2483,"_2607":12768,"_2610":12769,"_41":12770,"_69":68},[146],[1335],{},{"_35":206,"_2607":12772,"_2610":12773,"_41":12774,"_69":12775},[6479],[5146],{},"http://data.In","dehydrate(queryClient) and return that in the loader data.",{"_35":2509,"_37":12778,"_39":1945,"_41":12779,"_65":12780,"_67":12785,"_69":68},"BqyTd1Fq",{"_2582":2583},[12781],{"_35":2722,"_2607":12782,"_2610":12783,"_41":12784,"_69":68},[146],[1335],{},"On the server (loader)",{"_31":12787,"_33":12840},[12788,12799,12810,12821,12828],{"_31":12789,"_33":12790},[],{"_35":2509,"_37":12791,"_39":1945,"_41":12792,"_65":12793,"_67":12798,"_69":68},"yCT1UeSs",{},[12794],{"_35":2483,"_2607":12795,"_2610":12796,"_41":12797,"_69":68},[740,5454],[2357,4810],{},"Read dehydratedState from useLoaderData.",{"_31":12800,"_33":12801},[],{"_35":2509,"_37":12802,"_39":1945,"_41":12803,"_65":12804,"_67":12809,"_69":68},"J9Sb4b4Y",{},[12805],{"_35":2483,"_2607":12806,"_2610":12807,"_41":12808,"_69":68},[1111,5146],[4337,8572],{},"Wrap your UI in + .",{"_31":12811,"_33":12812},[],{"_35":2509,"_37":12813,"_39":1945,"_41":12814,"_65":12815,"_67":12820,"_69":68},"ad7Lfb0V",{},[12816],{"_35":2483,"_2607":12817,"_2610":12818,"_41":12819,"_69":68},[2724],[2609],{},"Inside that, use normal useQuery hooks.",{"_31":12822,"_33":12823},[],{"_35":2509,"_37":12824,"_39":1945,"_41":12825,"_65":12826,"_67":12827,"_69":68},"51Hg1532",{},[],"On the server render, React Query uses the prefetched cache.",{"_31":12829,"_33":12830},[],{"_35":2509,"_37":12831,"_39":1945,"_41":12832,"_65":12833,"_67":12839,"_69":68},"RtKZv78a",{},[12834],{"_35":206,"_2607":12835,"_2610":12836,"_41":12837,"_69":12838},[2883],[682],{},"http://data.name","On the first client render, React Query reuses that cache instead of refetching.",{"_35":2509,"_37":12841,"_39":1945,"_41":12842,"_65":12843,"_67":12848,"_69":68},"68b4HfdM",{"_2582":2583},[12844],{"_35":2722,"_2607":12845,"_2610":12846,"_41":12847,"_69":68},[146],[682],{},"In the route component (both server + client)",{"_35":2580,"_37":12850,"_39":1945,"_41":12851,"_65":12852,"_67":12853,"_69":68},"9EOqTSSe",{"_2582":2878},[],"Core idea",{"_31":12855,"_33":12856},[],{"_35":2509,"_37":12857,"_39":1945,"_41":12858,"_65":12859,"_67":12860,"_69":68},"_LESJKqb",{},[],"That’s the pattern.",{"_31":12862,"_33":12863},[],{"_35":2580,"_37":12864,"_39":1945,"_41":12865,"_65":12866,"_67":12867,"_69":68},"kDqnERyC",{},[],"Minimal example in Remix",{"_31":12869,"_33":12870},[],{"_35":2580,"_37":12871,"_39":1945,"_41":12872,"_65":12873,"_67":12874,"_69":68},"f5wgJyQ-",{},[],"1. Root setup",{"_31":12876,"_33":12877},[],{"_35":2509,"_37":12878,"_39":1945,"_41":12879,"_65":12880,"_67":12885,"_69":68},"pup37ide",{},[12881],{"_35":2722,"_2607":12882,"_2610":12883,"_41":12884,"_69":68},[146],[4855],{},"app/root.tsx",{"_31":12887,"_33":12888},[],{"_35":2483,"_37":12889,"_39":1945,"_41":12890,"_65":12891,"_67":12892,"_69":68},"DVQWKW1-",{"_2486":11038},[],"import type { LinksFunction, LoaderFunctionArgs } from \"@remix-run/node\";\nimport { json } from \"@remix-run/node\";\nimport {\n Links,\n Meta,\n Outlet,\n Scripts,\n ScrollRestoration,\n useLoaderData,\n} from \"@remix-run/react\";\nimport {\n QueryClient,\n QueryClientProvider,\n} from \"@tanstack/react-query\";\nimport { Hydrate, dehydrate } from \"@tanstack/react-query\";\nimport { useState } from \"react\";\nimport { getUser } from \"./models/user.server\"; // whatever\n\nexport async function loader(_args: LoaderFunctionArgs) {\n const queryClient = new QueryClient();\n\n // Preload whatever your route tree needs\n await queryClient.prefetchQuery({\n queryKey: [\"user\"],\n queryFn: () => getUser(),\n });\n\n return json({\n dehydratedState: dehydrate(queryClient),\n });\n}\n\nexport default function App() {\n const { dehydratedState } = useLoaderData();\n\n // important: create one client on the client, not on every render\n const [queryClient] = useState(\n () =>\n new QueryClient({\n defaultOptions: {\n queries: { refetchOnWindowFocus: false },\n },\n })\n );\n\n return (\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n );\n}\n",{"_31":12894,"_33":12917},[12895,12906],{"_31":12896,"_33":12897},[],{"_35":2509,"_37":12898,"_39":1945,"_41":12899,"_65":12900,"_67":12905,"_69":68},"cBdFgVzD",{},[12901],{"_35":2483,"_2607":12902,"_2610":12903,"_41":12904,"_69":68},[1892,682],[5454,4712],{},"Loader creates QueryClient, prefetches, then dehydrate.",{"_31":12907,"_33":12908},[],{"_35":2509,"_37":12909,"_39":1945,"_41":12910,"_65":12911,"_67":12916,"_69":68},"T3lkGSR_",{},[12912],{"_35":2483,"_2607":12913,"_2610":12914,"_41":12915,"_69":68},[4712],[5284],{},"Component re-creates a client (client-side stable via useState) and hydrates with loader data.",{"_35":2509,"_37":12918,"_39":1945,"_41":12919,"_65":12920,"_67":12921,"_69":68},"W2H4q0Wx",{"_2582":2583},[],"The key pieces for the pattern are:",{"_31":12923,"_33":12946},[12924,12935],{"_31":12925,"_33":12926},[],{"_35":2509,"_37":12927,"_39":1945,"_41":12928,"_65":12929,"_67":12934,"_69":68},"xPV6eMX-",{},[12930],{"_35":2483,"_2607":12931,"_2610":12932,"_41":12933,"_69":68},[4700],[4780],{},"Return their dehydratedState fragments.",{"_31":12936,"_33":12937},[],{"_35":2509,"_37":12938,"_39":1945,"_41":12939,"_65":12940,"_67":12945,"_69":68},"adZDI3SE",{},[12941],{"_35":2483,"_2607":12942,"_2610":12943,"_41":12944,"_69":68},[3566],[5146],{},"Merge them into a single dehydratedState in root (or have root loader do all prefetching centrally).",{"_35":2509,"_37":12947,"_39":1945,"_41":12948,"_65":12949,"_67":12954,"_69":68},"qbc0zlgC",{"_2582":2583},[12950],{"_35":2722,"_2607":12951,"_2610":12952,"_41":12953,"_69":68},[4700],[8503],{},"You can have more prefetching in child route loaders too, you just need to:",{"_31":12956,"_33":12957},[],{"_35":2509,"_37":12958,"_39":1945,"_41":12959,"_65":12960,"_67":12961,"_69":68},"_xYNawXG",{},[],"But simplest thing that actually works: root loader does the prefetch for the stuff you care about on first paint.",{"_31":12963,"_33":12964},[],{"_35":2580,"_37":12965,"_39":1945,"_41":12966,"_65":12967,"_67":12968,"_69":68},"KSPshdx1",{},[],"2. Normal useQuery in a route",{"_31":12970,"_33":12971},[],{"_35":2509,"_37":12972,"_39":1945,"_41":12973,"_65":12974,"_67":12979,"_69":68},"Gi8euXeD",{},[12975],{"_35":2722,"_2607":12976,"_2610":12977,"_41":12978,"_69":68},[146],[4797],{},"app/routes/_index.tsx",{"_31":12981,"_33":12982},[],{"_35":2483,"_37":12983,"_39":1945,"_41":12984,"_65":12985,"_67":12986,"_69":68},"BFHXiOHU",{"_2486":11038},[],"import { useQuery } from \"@tanstack/react-query\";\nimport { getUser } from \"~/models/user.server\"; // same fn, but don't import server fn in browser in real code; wrap in API call or isomorphic wrapper\n\nasync function fetchUser() {\n // in practice you'd hit an endpoint, not call a server fn directly\n return getUser();\n}\n\nexport default function Index() {\n const { data, isLoading } = useQuery({\n queryKey: [\"user\"],\n queryFn: fetchUser,\n });\n\n if (isLoading) return Loading… ;\n\n return Hi {data.name} ;\n}\n",{"_31":12988,"_33":12989},[],{"_35":2509,"_37":12990,"_39":1945,"_41":12991,"_65":12992,"_67":12997,"_69":68},"_jBer1B9",{},[12993],{"_35":2722,"_2607":12994,"_2610":12995,"_41":12996,"_69":68},[4855],[5454],{},"Because the query key + fn match the prefetched one, the first server render and first client render both pull from the same hydrated cache. Client does the normal React Query lifecycle after that.",{"_31":12999,"_33":13067},[13000,13019,13034],{"_31":13001,"_33":13002},[],{"_35":2509,"_37":13003,"_39":1945,"_41":13004,"_65":13005,"_67":13018,"_69":68},"XmGSKrts",{},[13006,13010,13014],{"_35":2722,"_2607":13007,"_2610":13008,"_41":13009,"_69":68},[146],[577],{},{"_35":2483,"_2607":13011,"_2610":13012,"_41":13013,"_69":68},[1335,5962,7165],[6479,6573,6219],{},{"_35":7569,"_2607":13015,"_2610":13016,"_41":13017,"_69":68},[4337],[5262],{},"Do not create a fresh QueryClient on every render of App. You already know this, but that’s why you see the useState(() => new QueryClient()) trick.",{"_31":13020,"_33":13021},[],{"_35":2509,"_37":13022,"_39":1945,"_41":13023,"_65":13024,"_67":13033,"_69":68},"qw0tASn7",{},[13025,13029],{"_35":2722,"_2607":13026,"_2610":13027,"_41":13028,"_69":68},[1257],[1111],{},{"_35":2483,"_2607":13030,"_2610":13031,"_41":13032,"_69":68},[1111,4732],[4797,2612],{},"For streaming / defer, you can’t just blindly use dehydrate once; you’d move some data to Remix’s data streams and possibly stop using React Query for that part.",{"_31":13035,"_33":13058},[13036,13047],{"_31":13037,"_33":13038},[],{"_35":2509,"_37":13039,"_39":1945,"_41":13040,"_65":13041,"_67":13046,"_69":68},"fm8W_87n",{},[13042],{"_35":2483,"_2607":13043,"_2610":13044,"_41":13045,"_69":68},[5932],[5934],{},"centralize prefetch in root loader (route loaders call into it), or",{"_31":13048,"_33":13049},[],{"_35":2509,"_37":13050,"_39":1945,"_41":13051,"_65":13052,"_67":13057,"_69":68},"QJT7Z-BR",{},[13053],{"_35":2483,"_2607":13054,"_2610":13055,"_41":13056,"_69":68},[2609,5835],[2727,6356],{},"have each loader return its own dehydratedState and merge in root (annoying, but doable).",{"_35":2509,"_37":13059,"_39":1945,"_41":13060,"_65":13061,"_67":13066,"_69":68},"QIUVYP1D",{"_2582":2583},[13062],{"_35":2722,"_2607":13063,"_2610":13064,"_41":13065,"_69":68},[309],[711],{},"If you start doing route-level prefetching, you either:",{"_35":2580,"_37":13068,"_39":1945,"_41":13069,"_65":13070,"_67":13071,"_69":68},"s1uCptpw",{"_2582":2583},[],"Subtle bits you’ll trip on if you’re not careful",{"_31":13073,"_33":13074},[],{"_35":2509,"_37":13075,"_39":1945,"_41":13076,"_65":13077,"_67":13086,"_69":68},"VcdbqCxC",{},[13078,13082],{"_35":2722,"_2607":13079,"_2610":13080,"_41":13081,"_69":68},[6141,5836],[4782,5965],{},{"_35":2483,"_2607":13083,"_2610":13084,"_41":13085,"_69":68},[4782,5965],[5836,4717],{},"But the “pattern” you’re asking for is exactly: loader prefetch → dehydrate → Hydrate + useQuery.",{"_35":2580,"_37":13088,"_39":1945,"_41":13089,"_65":13090,"_67":13091,"_69":68},"IyY14t8Q",{"_2582":239},[],"Specifics - from ChatGPT",[74,77],"/tech-talks/server-rendering-context","2025-12-19T13:25:53.422Z",{"_86":1954,"_88":1955},{},{"_92":1945,"_96":1952},{"_37":1932,"_104":53,"_54":13099,"_70":1935,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,1934],1778632074489,[158,1932,1935,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/server-rendering-context\",\"bafy2bzaceaytxh3wlv277trug6jd5g6qwcx2hzsb6w5muy3u54qdps5yrhk4i\",true]",{"_119":13104,"_156":13153,"_159":13154},{"_121":13105,"_141":44,"_142":13152,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":13106,"_37":13150},{"_28":13107,"_70":1961,"_71":53,"_72":13145,"_54":13146,"_80":1968,"_82":1968,"_84":13147,"_90":13148,"_92":1961,"_94":13149,"_98":99},[13108,13123,13130],{"_31":13109,"_33":13110},[],{"_35":2509,"_37":13111,"_39":1961,"_41":13112,"_65":13113,"_67":13122,"_69":68},"QEwbleet",{},[13114,13118],{"_35":2722,"_2607":13115,"_2610":13116,"_41":13117,"_69":68},[146,5267],[5733,5456],{},{"_35":2483,"_2607":13119,"_2610":13120,"_41":13121,"_69":68},[5733],[5267],{},"what's the difference between starting the app from the app icon vs typing seed in the terminal on Linux",{"_31":13124,"_33":13125},[],{"_35":2509,"_37":13126,"_39":1961,"_41":13127,"_65":13128,"_67":13129,"_69":68},"VBBi8X1I",{},[],"I saw different behavior when the app is open from the terminal and I don't understand what is different. or if it should be any difference?",{"_31":13131,"_33":13132},[],{"_35":2509,"_37":13133,"_39":1961,"_41":13134,"_65":13135,"_67":13144,"_69":68},"NlB5Orvh",{},[13136,13140],{"_35":4883,"_2607":13137,"_2610":13138,"_41":13139,"_69":2423},[4855],[4700],{},{"_35":4883,"_2607":13141,"_2610":13142,"_41":13143,"_69":2436},[840],[1892],{},"Do you know ?",[78],"/tech-talks/different-ways-to-open-the-app-in-linux",{"_86":1981,"_88":1982},{},{"_92":1961,"_96":1979},{"_37":1958,"_104":53,"_54":13151,"_70":1961,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,1960],1778632074467,[158,1958,1961,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/different-ways-to-open-the-app-in-linux\",\"bafy2bzacedw5bsk5pquz3e7bpp5vlmfkiawcduiipmga62s7bvdiwkh2cmsgo\",true]",{"_119":13156,"_156":13279,"_159":13280},{"_121":13157,"_141":44,"_142":13278,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":13158,"_37":13276},{"_28":13159,"_70":1988,"_71":53,"_72":13271,"_54":13272,"_80":1995,"_82":1995,"_84":13273,"_90":13274,"_92":1988,"_94":13275,"_98":99},[13160,13167],{"_31":13161,"_33":13162},[],{"_35":2509,"_37":13163,"_39":1988,"_41":13164,"_65":13165,"_67":13166,"_69":68},"xkZsOahb",{},[],"In case anybody else has to do this.",{"_31":13168,"_33":13266},[13169,13187,13205,13223,13241,13248],{"_31":13170,"_33":13182},[13171],{"_31":13172,"_33":13173},[],{"_35":2509,"_37":13174,"_39":1988,"_41":13175,"_65":13176,"_67":13181,"_69":68},"jlV65-j_",{},[13177],{"_35":2483,"_2607":13178,"_2610":13179,"_41":13180,"_69":68},[44],[309],{}," docker stop notify",{"_35":2509,"_37":13183,"_39":1988,"_41":13184,"_65":13185,"_67":13186,"_69":68},"uycKdG1u",{"_2582":239},[],"Stop Email Service",{"_31":13188,"_33":13200},[13189],{"_31":13190,"_33":13191},[],{"_35":2509,"_37":13192,"_39":1988,"_41":13193,"_65":13194,"_67":13199,"_69":68},"vJbBLf3O",{},[13195],{"_35":2483,"_2607":13196,"_2610":13197,"_41":13198,"_69":68},[146],[4716],{},"sudo sqlite3 /shm/gateway/notify/web-db.sqlite",{"_35":2509,"_37":13201,"_39":1988,"_41":13202,"_65":13203,"_67":13204,"_69":68},"AcUZrKRo",{"_2582":239},[],"Open the notifier db",{"_31":13206,"_33":13218},[13207],{"_31":13208,"_33":13209},[],{"_35":2509,"_37":13210,"_39":1988,"_41":13211,"_65":13212,"_67":13217,"_69":68},"VqhSrog0",{},[13213],{"_35":2483,"_2607":13214,"_2610":13215,"_41":13216,"_69":68},[146],[6232],{},"select * from notifier_status;",{"_35":2509,"_37":13219,"_39":1988,"_41":13220,"_65":13221,"_67":13222,"_69":68},"TAyWT7kF",{"_2582":239},[],"Read the status table, copy somewhere in case its helpful for later debugging",{"_31":13224,"_33":13236},[13225],{"_31":13226,"_33":13227},[],{"_35":2509,"_37":13228,"_39":1988,"_41":13229,"_65":13230,"_67":13235,"_69":68},"MJjKEh_m",{},[13231],{"_35":2483,"_2607":13232,"_2610":13233,"_41":13234,"_69":68},[146],[4780],{},"delete from notifier_status;",{"_35":2509,"_37":13237,"_39":1988,"_41":13238,"_65":13239,"_67":13240,"_69":68},"fm4_Fr2Z",{"_2582":239},[],"Empty the notifier status table",{"_31":13242,"_33":13243},[],{"_35":2509,"_37":13244,"_39":1988,"_41":13245,"_65":13246,"_67":13247,"_69":68},"O9RmjHvP",{},[],"Close sqlite (ctrl-d)",{"_31":13249,"_33":13261},[13250],{"_31":13251,"_33":13252},[],{"_35":2509,"_37":13253,"_39":1988,"_41":13254,"_65":13255,"_67":13260,"_69":68},"EkCqA-ao",{},[13256],{"_35":2483,"_2607":13257,"_2610":13258,"_41":13259,"_69":68},[146],[4732],{},"docker start notify && docker logs notify -f -n 10",{"_35":2509,"_37":13262,"_39":1988,"_41":13263,"_65":13264,"_67":13265,"_69":68},"69ONOC64",{"_2582":239},[],"Start the notifier service and watch logs",{"_35":2509,"_37":13267,"_39":1988,"_41":13268,"_65":13269,"_67":13270,"_69":68},"VNSUCdew",{"_2582":2878},[],"The workflow is pretty safe. It will reset the batch notification timer, and it should only send new notifications from the time you run this workflow.",[74],"/tech-talks/how-to-reset-email-service",{"_86":2008},{},{"_92":1988,"_96":2006},{"_37":1985,"_104":53,"_54":13277,"_70":1988,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,1987],1778632074503,[158,1985,1988,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/how-to-reset-email-service\",\"bafy2bzacec7k2jgfkan4q6yxparh4dfew5xhaenymkrollikrgjvgwhq2vlgs\",true]",{"_119":13282,"_156":13612,"_159":13613},{"_121":13283,"_141":44,"_142":13611,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":13284,"_37":13609},{"_28":13285,"_70":2014,"_71":53,"_72":13604,"_54":13605,"_80":2021,"_82":2021,"_84":13606,"_90":13607,"_92":2014,"_94":13608,"_98":99},[13286,13336,13438],{"_31":13287,"_33":13331},[13288,13317,13324],{"_31":13289,"_33":13312},[13290,13301],{"_31":13291,"_33":13292},[],{"_35":2509,"_37":13293,"_39":2014,"_41":13294,"_65":13295,"_67":13300,"_69":68},"k3jSGXdi",{},[13296],{"_35":2483,"_2607":13297,"_2610":13298,"_41":13299,"_69":68},[146],[840],{},"USER_ID@DOMAIN",{"_31":13302,"_33":13303},[],{"_35":2509,"_37":13304,"_39":2014,"_41":13305,"_65":13306,"_67":13311,"_69":68},"NxCaN5P8",{},[13307],{"_35":2483,"_2607":13308,"_2610":13309,"_41":13310,"_69":68},[4700],[4337],{},"For example, K3A8L45@seed.hyper.media",{"_35":2509,"_37":13313,"_39":2014,"_41":13314,"_65":13315,"_67":13316,"_69":68},"7lDyT9G0",{"_2582":239},[],"In addition to the existing account IDs (public keys), we will support a new format with the following shape:",{"_31":13318,"_33":13319},[],{"_35":2509,"_37":13320,"_39":2014,"_41":13321,"_65":13322,"_67":13323,"_69":68},"dw29JnJ4",{},[],"Inside each server, any authentication mechanism can be used to identify and resolve the UserID. For our initial implementation, we will use magic links.",{"_31":13325,"_33":13326},[],{"_35":2509,"_37":13327,"_39":2014,"_41":13328,"_65":13329,"_67":13330,"_69":68},"7knpYzUp",{},[],"These new Validator AccountIDs can be invited to documents, or mentioned. They can even have their own site, but that is not really recommended because they are dependent on another domain.",{"_35":2580,"_37":13332,"_39":2014,"_41":13333,"_65":13334,"_67":13335,"_69":68},"BuWRzJpP",{"_2582":239},[],"New Account ID format",{"_31":13337,"_33":13433},[13338,13345,13366,13387,13401,13415],{"_31":13339,"_33":13340},[],{"_35":2509,"_37":13341,"_39":2014,"_41":13342,"_65":13343,"_67":13344,"_69":68},"bRv1DnVu",{},[],"When you set up a ANY HM host, you must choose at least one of the following options.",{"_31":13346,"_33":13361},[13347,13354],{"_31":13348,"_33":13349},[],{"_35":2509,"_37":13350,"_39":2014,"_41":13351,"_65":13352,"_67":13353,"_69":68},"DAEuYKex",{},[],"In the server, add the SMTP settings (or Mailgun or something). Then the server has the ability to send notification and email settings.",{"_31":13355,"_33":13356},[],{"_35":2509,"_37":13357,"_39":2014,"_41":13358,"_65":13359,"_67":13360,"_69":68},"h8XUHtZU",{},[],"This will enable the \"sign in with email\" workflow. To sign in, the user will type their email address and click \"Verify my Email\"",{"_35":2580,"_37":13362,"_39":2014,"_41":13363,"_65":13364,"_67":13365,"_69":68},"mBF8yd8F",{"_2582":239},[],"Set Up Email Sending",{"_31":13367,"_33":13382},[13368,13375],{"_31":13369,"_33":13370},[],{"_35":2509,"_37":13371,"_39":2014,"_41":13372,"_65":13373,"_67":13374,"_69":68},"eXVRGbrJ",{},[],"The site owner will choose an Upstream Identity Provider where users will authenticate through",{"_31":13376,"_33":13377},[],{"_35":2509,"_37":13378,"_39":2014,"_41":13379,"_65":13380,"_67":13381,"_69":68},"xAIpQ1vl",{},[],"This will enable the \"sign in with \" workflow which feels to the user like OAuth.",{"_35":2580,"_37":13383,"_39":2014,"_41":13384,"_65":13385,"_67":13386,"_69":68},"x4qRxAW9",{"_2582":239},[],"Set Up Allowed Upstream Identity Provider(s)",{"_31":13388,"_33":13396},[13389],{"_31":13390,"_33":13391},[],{"_35":2509,"_37":13392,"_39":2014,"_41":13393,"_65":13394,"_67":13395,"_69":68},"X0fqo7nD",{},[],"Any upstream identity provider will be allowed. So the user can input their own domain. As long as that domain is using the HM protocol, it can provide identity for the current domain.",{"_35":2580,"_37":13397,"_39":2014,"_41":13398,"_65":13399,"_67":13400,"_69":68},"694x_sFr",{"_2582":239},[],"Enabled Any Upstream Identity Provider",{"_31":13402,"_33":13410},[13403],{"_31":13404,"_33":13405},[],{"_35":2509,"_37":13406,"_39":2014,"_41":13407,"_65":13408,"_67":13409,"_69":68},"YlEzOBDb",{},[],"A server may be configured to show the \"device linking\" flow that will allow the identity provider to be based in the desktop app or mobile app. This is the most secure option but it will require more steps from the user. So they should be encouraged to do this.",{"_35":2580,"_37":13411,"_39":2014,"_41":13412,"_65":13413,"_67":13414,"_69":68},"1EQRtjIY",{"_2582":239},[],"App-Based Identity",{"_31":13416,"_33":13428},[13417],{"_31":13418,"_33":13419},[],{"_35":2509,"_37":13420,"_39":2014,"_41":13421,"_65":13422,"_67":13427,"_69":68},"VIBx6whU",{},[13423],{"_35":2483,"_2607":13424,"_2610":13425,"_41":13426,"_69":68},[5483],[8153],{},"If there is no email sending setup, and if there is no upstream identity providers, then we will fall back to using hyper.media as the identity provider.",{"_35":2580,"_37":13429,"_39":2014,"_41":13430,"_65":13431,"_67":13432,"_69":68},"eJl-BIqG",{"_2582":239},[],"Fallback Identity Provider",{"_35":2580,"_37":13434,"_39":2014,"_41":13435,"_65":13436,"_67":13437,"_69":68},"7_c1aA3M",{"_2582":239},[],"Server Config Options",{"_31":13439,"_33":13599},[13440,13482,13502,13558,13572],{"_31":13441,"_33":13477},[13442,13449,13456,13463,13470],{"_31":13443,"_33":13444},[],{"_35":2509,"_37":13445,"_39":2014,"_41":13446,"_65":13447,"_67":13448,"_69":68},"BE0koj7_",{},[],"The user creates a comment on hyper.media and then is prompted to create an account. Or they directly click \"Create Account / Log In\" and the workflow starts.",{"_31":13450,"_33":13451},[],{"_35":2509,"_37":13452,"_39":2014,"_41":13453,"_65":13454,"_67":13455,"_69":68},"_7KOEQLz",{},[],"They get two options: App Identity (secure) or Email Identity (convenient).",{"_31":13457,"_33":13458},[],{"_35":2509,"_37":13459,"_39":2014,"_41":13460,"_65":13461,"_67":13462,"_69":68},"Pry3ufv-",{},[],"The user clicks Email, and they type their email address. When they submit, their browser's public key is sent alongside the email.",{"_31":13464,"_33":13465},[],{"_35":2509,"_37":13466,"_39":2014,"_41":13467,"_65":13468,"_67":13469,"_69":68},"--p8rUHZ",{},[],"The server generates a user ID or looks it up if the email has been used before. A token is generated and emailed to the user. When the email link is clicked, it becomes validated.",{"_31":13471,"_33":13472},[],{"_35":2509,"_37":13473,"_39":2014,"_41":13474,"_65":13475,"_67":13476,"_69":68},"517vZnAS",{},[],"Now when this accountID is mentioned or creates a comment, their name is \"Display Name (hyper.media)\"",{"_35":2580,"_37":13478,"_39":2014,"_41":13479,"_65":13480,"_67":13481,"_69":68},"uEAbN8fE",{"_2582":239},[],"Sign in with hyper.media",{"_31":13483,"_33":13497},[13484,13491],{"_31":13485,"_33":13486},[],{"_35":2509,"_37":13487,"_39":2014,"_41":13488,"_65":13489,"_67":13490,"_69":68},"Q2UszM3T",{},[],"User clicks on \"Sign in with hyper.media\" and there is an OAuth-style redirect to hyper.media where the user may already be signed in, or they can create an account, or they can sign in with the above workflow",{"_31":13492,"_33":13493},[],{"_35":2509,"_37":13494,"_39":2014,"_41":13495,"_65":13496,"_67":13476,"_69":68},"9CACO9bF",{},[],{"_35":2580,"_37":13498,"_39":2014,"_41":13499,"_65":13500,"_67":13501,"_69":68},"gQPNzNJ0",{"_2582":239},[],"Sign in with hyper.media from example.net - H.M is the identity provider",{"_31":13503,"_33":13553},[13504,13511,13546],{"_31":13505,"_33":13506},[],{"_35":2509,"_37":13507,"_39":2014,"_41":13508,"_65":13509,"_67":13510,"_69":68},"uXuGa02L",{},[],"Say we are at example.net (self hosted) and the site owners have disabled all identity provider except for their own email validation. The platform is trying to keep a very streamlined user experience and own all the emails. ",{"_31":13512,"_33":13541},[13513,13520,13527,13534],{"_31":13514,"_33":13515},[],{"_35":2509,"_37":13516,"_39":2014,"_41":13517,"_65":13518,"_67":13519,"_69":68},"-vnY-tsi",{},[],"User ID",{"_31":13521,"_33":13522},[],{"_35":2509,"_37":13523,"_39":2014,"_41":13524,"_65":13525,"_67":13526,"_69":68},"THixrWne",{},[],"Provider ID",{"_31":13528,"_33":13529},[],{"_35":2509,"_37":13530,"_39":2014,"_41":13531,"_65":13532,"_67":13533,"_69":68},"MOE0m9PL",{},[],"Domain (eg example.net)",{"_31":13535,"_33":13536},[],{"_35":2509,"_37":13537,"_39":2014,"_41":13538,"_65":13539,"_67":13540,"_69":68},"tJhLEQ28",{},[],"Signature",{"_35":2509,"_37":13542,"_39":2014,"_41":13543,"_65":13544,"_67":13545,"_69":68},"UNzU5hYL",{"_2582":2583},[],"The user creates a comment or clicks login/register. They see an email input and type their email. When they submit, their browser's public key is sent alongside the email. An email gets sent with a SMTP provider, and the user clicks the email. After confirmation the server signs a validation which contains:",{"_31":13547,"_33":13548},[],{"_35":2509,"_37":13549,"_39":2014,"_41":13550,"_65":13551,"_67":13552,"_69":68},"-z1nhXsi",{},[],"This validation will be distributed alongside the content to make sure that people know who this person is.",{"_35":2580,"_37":13554,"_39":2014,"_41":13555,"_65":13556,"_67":13557,"_69":68},"DYZuLbX7",{"_2582":239},[],"Sign in with email address - example.net is the identity provider",{"_31":13559,"_33":13567},[13560],{"_31":13561,"_33":13562},[],{"_35":2509,"_37":13563,"_39":2014,"_41":13564,"_65":13565,"_67":13566,"_69":68},"1s7W6Aq1",{},[],"Similar workflow to \"sign in with hyper.media\" but the user is allowed to type any domain. They will be redirected to this domain for auth.",{"_35":2580,"_37":13568,"_39":2014,"_41":13569,"_65":13570,"_67":13571,"_69":68},"HzdM4ja9",{"_2582":239},[],"Sign in with , user input domain",{"_31":13573,"_33":13594},[13574,13581,13588],{"_31":13575,"_33":13576},[],{"_35":2509,"_37":13577,"_39":2014,"_41":13578,"_65":13579,"_67":13580,"_69":68},"u9lNW-RA",{},[],"Similar to the device linking workflow we have today, ideally with an improved UX and with mobile app support",{"_31":13582,"_33":13583},[],{"_35":2509,"_37":13584,"_39":2014,"_41":13585,"_65":13586,"_67":13587,"_69":68},"RE2m5xjr",{},[],"Their account ID will just be the normal key-based account ID of the app identity. When this account is mentioned or when they make a comment, their self-proclaimed name will be shown without any domain name.",{"_31":13589,"_33":13590},[],{"_35":2509,"_37":13591,"_39":2014,"_41":13592,"_65":13593,"_67":68,"_69":68},"lBC9htkH",{},[],{"_35":2580,"_37":13595,"_39":2014,"_41":13596,"_65":13597,"_67":13598,"_69":68},"rJ7UreoQ",{"_2582":239},[],"Sign in with Seed App",{"_35":2580,"_37":13600,"_39":2014,"_41":13601,"_65":13602,"_67":13603,"_69":68},"3ITDMWg7",{"_2582":239},[],"User Auth Workflow Options",[74],"/tech-talks/notes-on-validation-auth-providers",{"_86":2034},{},{"_92":2014,"_96":2032},{"_37":2011,"_104":53,"_54":13610,"_70":2014,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,2013],1778632074410,[158,2011,2014,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/notes-on-validation-auth-providers\",\"bafy2bzaceduqbgedwemclumwdpedxmg3yblgywqhrfnip3fcepfjpqzlhdc6y\",true]",{"_119":13615,"_156":13785,"_159":13786},{"_121":13616,"_141":44,"_142":13784,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":13617,"_37":13782},{"_28":13618,"_70":2040,"_71":53,"_72":13777,"_54":13778,"_80":2047,"_82":2047,"_84":13779,"_90":13780,"_92":2040,"_94":13781,"_98":99},[13619,13630,13667,13727],{"_31":13620,"_33":13621},[],{"_35":2509,"_37":13622,"_39":2040,"_41":13623,"_65":13624,"_67":13629,"_69":68},"1hGYYIsT",{},[13625],{"_35":2722,"_2607":13626,"_2610":13627,"_41":13628,"_69":68},[4856,5962,7891],[4781,5266,8572],{},"Seed Hypermedia’s p2p sync is built around identity, trust, and relevance. Because of that, it is fundamentally different from gossip protocols, even if both operate in distributed, peer-to-peer environments.",{"_31":13631,"_33":13662},[13632,13644,13655],{"_31":13633,"_33":13634},[],{"_35":2509,"_37":13635,"_39":2040,"_41":13636,"_65":13637,"_67":13643,"_69":68},"ked_xdUD",{},[13638],{"_35":7569,"_2607":13639,"_2610":13640,"_41":13642,"_69":68},[7538],[13641],160,{},"Gossip protocols disseminate messages across a broad or semi-broad set of peers using mesh fanout and probabilistic forwarding. They don’t know who specifically should receive the message- only that it should spread. This just allows spam to spread.",{"_31":13645,"_33":13646},[],{"_35":2509,"_37":13647,"_39":2040,"_41":13648,"_65":13649,"_67":13654,"_69":68},"uWUBi1_y",{},[13650],{"_35":2722,"_2607":13651,"_2610":13652,"_41":13653,"_69":68},[6479],[5477],{},"Seed sync has the opposite goal: replicate resources only to peers with explicit trust or relevance relationships.",{"_31":13656,"_33":13657},[],{"_35":2509,"_37":13658,"_39":2040,"_41":13659,"_65":13660,"_67":13661,"_69":68},"PLRJvRfR",{},[],"No broadcast. No fanout.",{"_35":2580,"_37":13663,"_39":2040,"_41":13664,"_65":13665,"_67":13666,"_69":68},"HT6PQnNL",{"_2582":239},[],"1. Gossip spreads widely; Seed sync is narrowly scoped",{"_31":13668,"_33":13722},[13669,13704,13715],{"_31":13670,"_33":13699},[13671,13678,13692],{"_31":13672,"_33":13673},[],{"_35":2509,"_37":13674,"_39":2040,"_41":13675,"_65":13676,"_67":13677,"_69":68},"8E06HnxB",{},[],"verified ownership of sites",{"_31":13679,"_33":13687},[13680],{"_31":13681,"_33":13682},[],{"_35":2509,"_37":13683,"_39":2040,"_41":13684,"_65":13685,"_67":13686,"_69":68},"as3ol4i1",{},[],"including identity delegation, or",{"_35":2509,"_37":13688,"_39":2040,"_41":13689,"_65":13690,"_67":13691,"_69":68},"thuVS0Dp",{"_2582":2583},[],"trusted contacts (and therefore peers),",{"_31":13693,"_33":13694},[],{"_35":2509,"_37":13695,"_39":2040,"_41":13696,"_65":13697,"_67":13698,"_69":68},"czbk7Qs_",{},[],"explicit subscriptions.",{"_35":2509,"_37":13700,"_39":2040,"_41":13701,"_65":13702,"_67":13703,"_69":68},"G3wjD5CY",{"_2582":2583},[],"Eligible recipients are known in advance via:",{"_31":13705,"_33":13706},[],{"_35":2509,"_37":13707,"_39":2040,"_41":13708,"_65":13709,"_67":13714,"_69":68},"OFtGor1Q",{},[13710],{"_35":2722,"_2607":13711,"_2610":13712,"_41":13713,"_69":68},[985,4808,4701],[1111,3566,4716],{},"This is directed, bounded, and user-controlled, not emergent or random.",{"_31":13716,"_33":13717},[],{"_35":2509,"_37":13718,"_39":2040,"_41":13719,"_65":13720,"_67":13721,"_69":68},"7oF-l-95",{},[],"We should never push content to uninterested or random peers.",{"_35":2580,"_37":13723,"_39":2040,"_41":13724,"_65":13725,"_67":13726,"_69":68},"_dMtH5uo",{"_2582":239},[],"2. Seed’s propagation graph is identity-defined",{"_31":13728,"_33":13768},[13729,13757],{"_31":13730,"_33":13752},[13731,13738,13745],{"_31":13732,"_33":13733},[],{"_35":2509,"_37":13734,"_39":2040,"_41":13735,"_65":13736,"_67":13737,"_69":68},"ICXNJzNA",{},[],"mesh spreading,",{"_31":13739,"_33":13740},[],{"_35":2509,"_37":13741,"_39":2040,"_41":13742,"_65":13743,"_67":13744,"_69":68},"__U1W-s9",{},[],"redundant forwarding of blobs, or,",{"_31":13746,"_33":13747},[],{"_35":2509,"_37":13748,"_39":2040,"_41":13749,"_65":13750,"_67":13751,"_69":68},"kMGHqngb",{},[],"probabilistic delivery across the network.",{"_35":2509,"_37":13753,"_39":2040,"_41":13754,"_65":13755,"_67":13756,"_69":68},"Ux5m2H_n",{"_2582":2583},[],"Gossip relies on repeated spreading until high-probability coverage is reached. Seed does not perform:",{"_31":13758,"_33":13759},[],{"_35":2509,"_37":13760,"_39":2040,"_41":13761,"_65":13762,"_67":13767,"_69":68},"-tWwgXQS",{},[13763],{"_35":2722,"_2607":13764,"_2610":13765,"_41":13766,"_69":68},[4797],[5946],{},"Our sync should have targeted delivery, not epidemic dissemination.",{"_35":2580,"_37":13769,"_39":2040,"_41":13770,"_65":13771,"_67":13776,"_69":68},"asf0lBvZ",{"_2582":239},[13772],{"_35":2722,"_2607":13773,"_2610":13774,"_41":13775,"_69":68},[146],[5986],{},"3. Seed does not use epidemic convergence",[74],"/tech-talks/our-syncing-model-should-not-be-a-gossip-protocol",{"_86":2060},{},{"_92":2040,"_96":2058},{"_37":2037,"_104":53,"_54":13783,"_70":2040,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,2039],1778632074319,[158,2037,2040,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/our-syncing-model-should-not-be-a-gossip-protocol\",\"bafy2bzacecyh35dx2p2gwienoymmqeixeawthgcayzv4deji63goukkql54wo\",true]",{"_119":13788,"_156":14072,"_159":14073},{"_121":13789,"_141":44,"_142":14071,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":13790,"_37":14069},{"_28":13791,"_70":2066,"_71":53,"_72":14064,"_54":14065,"_80":2073,"_82":2073,"_84":14066,"_90":14067,"_92":2066,"_94":14068,"_98":99},[13792],{"_31":13793,"_33":14059},[13794,13936,13943,13957],{"_31":13795,"_33":13931},[13796],{"_31":13797,"_33":13926},[13798,13913],{"_31":13799,"_33":13908},[13800],{"_31":13801,"_33":13899},[13802,13869],{"_31":13803,"_33":13860},[13804,13811,13832,13846,13853],{"_31":13805,"_33":13806},[],{"_35":2509,"_37":13807,"_39":2066,"_41":13808,"_65":13809,"_67":13810,"_69":68},"k9kMnX7N",{},[],"latestVersion: [cid1.cid2]",{"_31":13812,"_33":13827},[13813,13820],{"_31":13814,"_33":13815},[],{"_35":2509,"_37":13816,"_39":2066,"_41":13817,"_65":13818,"_67":13819,"_69":68},"QUzLTAHo",{},[],"resource: [AccountID+Path]",{"_31":13821,"_33":13822},[],{"_35":2509,"_37":13823,"_39":2066,"_41":13824,"_65":13825,"_67":13826,"_69":68},"0ivNFf9j",{},[],"mention metadata?",{"_35":2509,"_37":13828,"_39":2066,"_41":13829,"_65":13830,"_67":13831,"_69":68},"k_5eGN-A",{"_2582":2583},[],"mentions array:",{"_31":13833,"_33":13841},[13834],{"_31":13835,"_33":13836},[],{"_35":2509,"_37":13837,"_39":2066,"_41":13838,"_65":13839,"_67":13840,"_69":68},"FTwY0DG6",{},[],"[Resource: AccountID+Path]",{"_35":2509,"_37":13842,"_39":2066,"_41":13843,"_65":13844,"_67":13845,"_69":68},"DoUUCqZF",{"_2582":2583},[],"comments array:",{"_31":13847,"_33":13848},[],{"_35":2509,"_37":13849,"_39":2066,"_41":13850,"_65":13851,"_67":13852,"_69":68},"k6PuOvTE",{},[],"activity: TBD - cache the activity events about this specific resource",{"_31":13854,"_33":13855},[],{"_35":2509,"_37":13856,"_39":2066,"_41":13857,"_65":13858,"_67":13859,"_69":68},"NJLIN6qm",{},[],"search: TBD - cache search results when your search is narrowed to this resource",{"_35":2509,"_37":13861,"_39":2066,"_41":13862,"_65":13863,"_67":13868,"_69":68},"K5BOsXu6",{"_2582":2583},[13864],{"_35":2483,"_2607":13865,"_2610":13866,"_41":13867,"_69":68},[740],[309],{},"when type: Document",{"_31":13870,"_33":13890},[13871,13878],{"_31":13872,"_33":13873},[],{"_35":2509,"_37":13874,"_39":2066,"_41":13875,"_65":13876,"_67":13877,"_69":68},"Z375PsLT",{},[],"latestVersion: [cid]",{"_31":13879,"_33":13886},[13880],{"_31":13881,"_33":13882},[],{"_35":2509,"_37":13883,"_39":2066,"_41":13884,"_65":13885,"_67":13819,"_69":68},"ft4OLTgV",{},[],{"_35":2509,"_37":13887,"_39":2066,"_41":13888,"_65":13889,"_67":13831,"_69":68},"-KTDM5lH",{"_2582":2583},[],{"_35":2509,"_37":13891,"_39":2066,"_41":13892,"_65":13893,"_67":13898,"_69":68},"0L6HMmHj",{"_2582":2583},[13894],{"_35":2483,"_2607":13895,"_2610":13896,"_41":13897,"_69":68},[740],[4808],{},"when type: Comment",{"_35":2509,"_37":13900,"_39":2066,"_41":13901,"_65":13902,"_67":13907,"_69":68},"Q0J-mkkC",{"_2582":2583},[13903],{"_35":2483,"_2607":13904,"_2610":13905,"_41":13906,"_69":68},[4337,5266],[485,8572],{},"[Path] - empty string for home docs, /[TSID] for CCC, and /human/readable for children docs",{"_35":2509,"_37":13909,"_39":2066,"_41":13910,"_65":13911,"_67":13912,"_69":68},"0YX6RaxJ",{"_2582":2583},[],"Paths",{"_31":13914,"_33":13922},[13915],{"_31":13916,"_33":13917},[],{"_35":2509,"_37":13918,"_39":2066,"_41":13919,"_65":13920,"_67":13921,"_69":68},"MmRH7Wgv",{},[],"latestCid: [cid]",{"_35":2509,"_37":13923,"_39":2066,"_41":13924,"_65":13925,"_67":4980,"_69":68},"c0MRUt7l",{"_2582":2583},[],{"_35":2509,"_37":13927,"_39":2066,"_41":13928,"_65":13929,"_67":13930,"_69":68},"mYQqAN76",{"_2582":2583},[],"[Account_ID]",{"_35":2509,"_37":13932,"_39":2066,"_41":13933,"_65":13934,"_67":13935,"_69":68},"P9kUtE8T",{"_2582":2583},[],"Account",{"_31":13937,"_33":13938},[],{"_35":2509,"_37":13939,"_39":2066,"_41":13940,"_65":13941,"_67":13942,"_69":68},"un5elriM",{},[],"search - used to cache search results when searching the whole node",{"_31":13944,"_33":13952},[13945],{"_31":13946,"_33":13947},[],{"_35":2509,"_37":13948,"_39":2066,"_41":13949,"_65":13950,"_67":13951,"_69":68},"03ioYvMj",{},[],"will reference the Path Resources: [AccountID+Path] or the Profile: [AccountID]",{"_35":2509,"_37":13953,"_39":2066,"_41":13954,"_65":13955,"_67":13956,"_69":68},"aJM2Yp05",{"_2582":2583},[],"activity - cache the node's global activity events",{"_31":13958,"_33":14054},[13959,14021],{"_31":13960,"_33":14016},[13961,13995],{"_31":13962,"_33":13990},[13963,13983],{"_31":13964,"_33":13978},[13965,13972],{"_31":13966,"_33":13967},[],{"_35":2509,"_37":13968,"_39":2066,"_41":13969,"_65":13970,"_67":13971,"_69":68},"fVXwPqfh",{},[],"Metadata",{"_31":13973,"_33":13974},[],{"_35":2509,"_37":13975,"_39":2066,"_41":13976,"_65":13977,"_67":7120,"_69":68},"7lC8HTkX",{},[],{"_35":2509,"_37":13979,"_39":2066,"_41":13980,"_65":13981,"_67":13982,"_69":68},"rYdfc83i",{"_2582":2583},[],"State - the current state",{"_31":13984,"_33":13985},[],{"_35":2509,"_37":13986,"_39":2066,"_41":13987,"_65":13988,"_67":13989,"_69":68},"5pi1OrxG",{},[],"Blob Data (as it saved in IPFS)",{"_35":2509,"_37":13991,"_39":2066,"_41":13992,"_65":13993,"_67":13994,"_69":68},"gLWkB8w3",{"_2582":2583},[],"when a document change:",{"_31":13996,"_33":14011},[13997,14004],{"_31":13998,"_33":13999},[],{"_35":2509,"_37":14000,"_39":2066,"_41":14001,"_65":14002,"_67":14003,"_69":68},"io1m56fJ",{},[],"Blob Data (as it is saved in IPFS)",{"_31":14005,"_33":14006},[],{"_35":2509,"_37":14007,"_39":2066,"_41":14008,"_65":14009,"_67":14010,"_69":68},"9l7BoUuR",{},[],"Metadata? If only used if the full blob data is not loaded",{"_35":2509,"_37":14012,"_39":2066,"_41":14013,"_65":14014,"_67":14015,"_69":68},"O4pp5l6Z",{"_2582":2583},[],"when a comment, cap, contact, profile:",{"_35":2509,"_37":14017,"_39":2066,"_41":14018,"_65":14019,"_67":14020,"_69":68},"qr32bZWk",{"_2582":2583},[],"[CID]",{"_31":14022,"_33":14049},[14023,14030],{"_31":14024,"_33":14025},[],{"_35":2509,"_37":14026,"_39":2066,"_41":14027,"_65":14028,"_67":14029,"_69":68},"Ta5nr5sx",{},[],"for document versions only",{"_31":14031,"_33":14044},[14032,14038],{"_31":14033,"_33":14034},[],{"_35":2509,"_37":14035,"_39":2066,"_41":14036,"_65":14037,"_67":13971,"_69":68},"YVeXFKhT",{},[],{"_31":14039,"_33":14040},[],{"_35":2509,"_37":14041,"_39":2066,"_41":14042,"_65":14043,"_67":7120,"_69":68},"cLV-Hsm6",{},[],{"_35":2509,"_37":14045,"_39":2066,"_41":14046,"_65":14047,"_67":14048,"_69":68},"Yl65tRYq",{"_2582":2583},[],"State - if this is a document version",{"_35":2509,"_37":14050,"_39":2066,"_41":14051,"_65":14052,"_67":14053,"_69":68},"qr9nQzJ0",{"_2582":2583},[],"[CID1.CID2]",{"_35":2509,"_37":14055,"_39":2066,"_41":14056,"_65":14057,"_67":14058,"_69":68},"cHR9eIUP",{"_2582":2583},[],"Immutable",{"_35":2509,"_37":14060,"_39":2066,"_41":14061,"_65":14062,"_67":14063,"_69":68},"Uf_VvD3_",{"_2582":2583},[],"On the frontend team we are designing the new normalized data structure, which is how the client will organize all data that is received from the API",[74],"/tech-talks/normalized-data-shape",{"_86":2082},{},{"_92":2066,"_96":2080},{"_37":2063,"_104":53,"_54":14070,"_70":2066,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,2065],1778632074411,[158,2063,2066,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/normalized-data-shape\",\"bafy2bzacebhphgzlfsmzgwx4xveuxmu6nmdmuwixvz4sfq6gmtiercq4t43js\",true]",{"_119":14075,"_156":14306,"_159":14307},{"_121":14076,"_141":44,"_142":14305,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":14077,"_37":14303},{"_28":14078,"_70":2113,"_71":53,"_72":14298,"_54":14299,"_80":2120,"_82":2120,"_84":14300,"_90":14301,"_92":2113,"_94":14302,"_98":99},[14079,14086,14167,14270],{"_31":14080,"_33":14081},[],{"_35":2509,"_37":14082,"_39":2113,"_41":14083,"_65":14084,"_67":14085,"_69":68},"KToeRvO_",{},[],"We have been making progress towards reducing redundant code when querying data from web and desktop. This proposal takes another big step in that direction.",{"_31":14087,"_33":14162},[14088,14095,14127,14141,14148,14155],{"_31":14089,"_33":14090},[],{"_35":2509,"_37":14091,"_39":2113,"_41":14092,"_65":14093,"_67":14094,"_69":68},"qL-jOEon",{},[],"When introducing a new feature that loads data from the daemon, we have to write a lot of code to implement it on web and desktop.",{"_31":14096,"_33":14118},[14097,14104,14111],{"_31":14098,"_33":14099},[],{"_35":2509,"_37":14100,"_39":2113,"_41":14101,"_65":14102,"_67":14103,"_69":68},"7kcvHJKo",{},[],"is harder to maintain",{"_31":14105,"_33":14106},[],{"_35":2509,"_37":14107,"_39":2113,"_41":14108,"_65":14109,"_67":14110,"_69":68},"EFW1PkO_",{},[],"may cause different behavior between platforms",{"_31":14112,"_33":14113},[],{"_35":2509,"_37":14114,"_39":2113,"_41":14115,"_65":14116,"_67":14117,"_69":68},"Z9QT18EG",{},[],"might force us to solve the same bug twice",{"_35":2509,"_37":14119,"_39":2113,"_41":14120,"_65":14121,"_67":14126,"_69":68},"GFJ9512r",{"_2582":2583},[14122],{"_35":2483,"_2607":14123,"_2610":14124,"_41":14125,"_69":68},[5267],[5475],{},"Some of our existing endpoints do not properly share code. For example see how grpcClient.entities.searchEntities is called with different code on web and desktop, which:",{"_31":14128,"_33":14129},[],{"_35":2509,"_37":14130,"_39":2113,"_41":14131,"_65":14132,"_67":14140,"_69":68},"VdPSGVDw",{},[14133],{"_35":2483,"_2607":14134,"_2610":14136,"_41":14139,"_69":68},[5263,5463,14135],218,[5264,14137,14138],137,232,{},"The easiest way to understand this issue is by looking at the implementations of desktop-universal-client and create-web-universal-client. Note how some of these code paths share the underlying implementation, such as fetchDirectory, but most of them do not.",{"_31":14142,"_33":14143},[],{"_35":2509,"_37":14144,"_39":2113,"_41":14145,"_65":14146,"_67":14147,"_69":68},"IUnDHh3T",{},[],"An API router would act as a uniform solution to these two problems, reducing boilerplate and enforcing shared code patterns.",{"_31":14149,"_33":14150},[],{"_35":2509,"_37":14151,"_39":2113,"_41":14152,"_65":14153,"_67":14154,"_69":68},"-X08Ufdn",{},[],"This new pattern will make it more difficult to have fragmented code with different behavior and different bugs. So it will encourage us to have better code.",{"_31":14156,"_33":14157},[],{"_35":2509,"_37":14158,"_39":2113,"_41":14159,"_65":14160,"_67":14161,"_69":68},"A7HwITjY",{},[],"In our current \"universal client\" we also have a mix of fetchers and hooks. We should move to the fetcher pattern which will be enable a more lightweight \"universal client\", and will be more consistent than having a mix of patterns.",{"_35":2580,"_37":14163,"_39":2113,"_41":14164,"_65":14165,"_67":14166,"_69":68},"kYakHXBk",{"_2582":239},[],"Our Current Situation",{"_31":14168,"_33":14265},[14169,14211,14218,14225,14232,14244],{"_31":14170,"_33":14206},[14171,14178,14185,14192,14199],{"_31":14172,"_33":14173},[],{"_35":2509,"_37":14174,"_39":2113,"_41":14175,"_65":14176,"_67":14177,"_69":68},"ioypqSJp",{},[],"a key/name to identify it",{"_31":14179,"_33":14180},[],{"_35":2509,"_37":14181,"_39":2113,"_41":14182,"_65":14183,"_67":14184,"_69":68},"aGwRfzfi",{},[],"zod(ts) types for input and output",{"_31":14186,"_33":14187},[],{"_35":2509,"_37":14188,"_39":2113,"_41":14189,"_65":14190,"_67":14191,"_69":68},"m8tQllYp",{},[],"an implementation that takes a strongly typed input and returns a strongly-typed HMType, using the GRPC client",{"_31":14193,"_33":14194},[],{"_35":2509,"_37":14195,"_39":2113,"_41":14196,"_65":14197,"_67":14198,"_69":68},"ft_x-c10",{},[],"optional: provide details for serializing+deserializing the input to a URL",{"_31":14200,"_33":14201},[],{"_35":2509,"_37":14202,"_39":2113,"_41":14203,"_65":14204,"_67":14205,"_69":68},"PFjCqUTg",{},[],"future: optionally defines caching metadata for HTTP cache and intelligent client caching",{"_35":2509,"_37":14207,"_39":2113,"_41":14208,"_65":14209,"_67":14210,"_69":68},"FJTtc9yD",{"_2582":2583},[],"We will introduce a new API router which allows us to specify endpoints for querying data. Each endpoint has:",{"_31":14212,"_33":14213},[],{"_35":2509,"_37":14214,"_39":2113,"_41":14215,"_65":14216,"_67":14217,"_69":68},"K5J5G1nH",{},[],"We can convert each endpoint, one at a time. Eventually the \"desktop-universal-client\" and \"create-web-universal-client\" files will loose all of the specific fetchers and hooks. So you won't need to touch these files when introducing or modifying the data endpoints.",{"_31":14219,"_33":14220},[],{"_35":2509,"_37":14221,"_39":2113,"_41":14222,"_65":14223,"_67":14224,"_69":68},"V4Id-lW8",{},[],"This solution will use zod validation always, instead of type coercion, to ensure that the frontend code always receives valid data according to the schemas. Even when we have API drift (which should happen rarely, anyways), the frontend will have predictable errors.",{"_31":14226,"_33":14227},[],{"_35":2509,"_37":14228,"_39":2113,"_41":14229,"_65":14230,"_67":14231,"_69":68},"IRwD9CAf",{},[],"In addition, the client model hooks should be shared between platforms, so you will only have to implement one when creating a new endpoint.",{"_31":14233,"_33":14234},[],{"_35":2509,"_37":14235,"_39":2113,"_41":14236,"_65":14237,"_67":14243,"_69":68},"Od7Kiui0",{},[14238],{"_35":206,"_2607":14239,"_2610":14240,"_41":14241,"_69":14242},[4337],[5836],{},"https://github.com/seed-hypermedia/seed/pull/127","Take a look a the pull request here: https://github.com/seed-hypermedia/seed/pull/127",{"_31":14245,"_33":14260},[14246,14253],{"_31":14247,"_33":14248},[],{"_35":2509,"_37":14249,"_39":2113,"_41":14250,"_65":14251,"_67":14252,"_69":68},"Vq-TmmUa",{},[],"For now we will continue using React Query",{"_31":14254,"_33":14255},[],{"_35":2509,"_37":14256,"_39":2113,"_41":14257,"_65":14258,"_67":14259,"_69":68},"Z4AAhi26",{},[],"For now we will continue with the pattern where the desktop frontend calls gRPC directly. Eventually we may decide to run the API router on the middle end, exposing the same http interface to the desktop windows as we use on web. Until we have a more sophisticated invalidation system, there is little benefit in this change (and may result in a little extra overhead because of the extra server).",{"_35":2580,"_37":14261,"_39":2113,"_41":14262,"_65":14263,"_67":14264,"_69":68},"8NtZizPg",{"_2582":239},[],"No Goes",{"_35":2580,"_37":14266,"_39":2113,"_41":14267,"_65":14268,"_67":14269,"_69":68},"10EEayjj",{"_2582":239},[],"An Incremental Solution",{"_31":14271,"_33":14293},[14272,14279,14286],{"_31":14273,"_33":14274},[],{"_35":2509,"_37":14275,"_39":2113,"_41":14276,"_65":14277,"_67":14278,"_69":68},"31jZQXE5",{},[],"This is an incremental step that will be far easier to implement in our current codebase.",{"_31":14280,"_33":14281},[],{"_35":2509,"_37":14282,"_39":2113,"_41":14283,"_65":14284,"_67":14285,"_69":68},"03rEFbVw",{},[],"Vanilla GraphQL does not support caching very well using HTTP primitives, and we want to make sure.",{"_31":14287,"_33":14288},[],{"_35":2509,"_37":14289,"_39":2113,"_41":14290,"_65":14291,"_67":14292,"_69":68},"zYeEt3iS",{},[],"If we do decide to adopt GraphQL in the future, it will be easier to transition from this uniform pattern than the mess that we have today.",{"_35":2580,"_37":14294,"_39":2113,"_41":14295,"_65":14296,"_67":14297,"_69":68},"Q82qF0Wb",{"_2582":239},[],"Why this approach is better than GraphQL",[74],"/tech-talks/query-router-proposal",{"_86":2133,"_88":2134},{},{"_92":2113,"_96":2131},{"_37":2110,"_104":53,"_54":14304,"_70":2113,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,2112],1778632074405,[158,2110,2113,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/query-router-proposal\",\"bafy2bzacect5jcnf6qbxsqmtdgqghr5cikvfhogx3jfzvpbvw2e7lyy3bwntg\",true]",{"_119":14309,"_156":14787,"_159":14788},{"_121":14310,"_141":44,"_142":14786,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":14311,"_37":14784},{"_28":14312,"_70":2140,"_71":53,"_72":14779,"_54":14780,"_80":2147,"_82":2147,"_84":14781,"_90":14782,"_92":2140,"_94":14783,"_98":99},[14313,14525],{"_31":14314,"_33":14521},[14315,14392,14399,14406,14474],{"_31":14316,"_33":14383},[14317,14328,14339,14350,14361,14372],{"_31":14318,"_33":14319},[],{"_35":2509,"_37":14320,"_39":2140,"_41":14321,"_65":14322,"_67":14327,"_69":68},"Nd76QfcL",{},[14323],{"_35":2483,"_2607":14324,"_2610":14325,"_41":14326,"_69":68},[146,6479],[6232,5962],{},"@shm/shared/resource-loader.ts → createResourceLoader — throws on error, no extra work",{"_31":14329,"_33":14330},[],{"_35":2509,"_37":14331,"_39":2140,"_41":14332,"_65":14333,"_67":14338,"_69":68},"8ij4oY3j",{},[14334],{"_35":2483,"_2607":14335,"_2610":14336,"_41":14337,"_69":68},[146,4797,4856],[4808,2609,8503],{},"web/loaders.ts:370 → getResource — returns not-found, no extra work",{"_31":14340,"_33":14341},[],{"_35":2509,"_37":14342,"_39":2140,"_41":14343,"_65":14344,"_67":14349,"_69":68},"JnfCJUzW",{},[14345],{"_35":2483,"_2607":14346,"_2610":14347,"_41":14348,"_69":68},[146,4797],[4808,6479],{},"web/loaders.ts:407 → loadResource — throws on error, adds author metadata etc (see below)",{"_31":14351,"_33":14352},[],{"_35":2509,"_37":14353,"_39":2140,"_41":14354,"_65":14355,"_67":14360,"_69":68},"QOHHpR8R",{},[14356],{"_35":2483,"_2607":14357,"_2610":14358,"_41":14359,"_69":68},[146,2357,711],[4715,4701,4781],{},"notify/loaders.ts → getResource — returns not-found, no extra work",{"_31":14362,"_33":14363},[],{"_35":2509,"_37":14364,"_39":2140,"_41":14365,"_65":14366,"_67":14371,"_69":68},"RELZmeX2",{},[14367],{"_35":2483,"_2607":14368,"_2610":14369,"_41":14370,"_69":68},[146,2357],[4715,2609],{},"notify/loaders.ts → loadResource — throws on error, same as web",{"_31":14373,"_33":14374},[],{"_35":2509,"_37":14375,"_39":2140,"_41":14376,"_65":14377,"_67":14382,"_69":68},"MMFiay5P",{},[14378],{"_35":2483,"_2607":14379,"_2610":14380,"_41":14381,"_69":68},[146,5454,5262],[5932,5946,5266],{},"desktop/entities.ts:154 → loadResource — returns not-found, no extra work",{"_35":2509,"_37":14384,"_39":2140,"_41":14385,"_65":14386,"_67":14391,"_69":68},"myUV0kFQ",{"_2582":2583},[14387],{"_35":2483,"_2607":14388,"_2610":14389,"_41":14390,"_69":68},[2883],[5147],{},"Six places make the same GRPC call (grpcClient.resources.getResource):",{"_31":14393,"_33":14394},[],{"_35":2509,"_37":14395,"_39":2140,"_41":14396,"_65":14397,"_67":14398,"_69":68},"1ypN8M5k",{},[],"This means that we have duplicate or conflicting logic about processing the GRPC data, across many different locations in the code.",{"_31":14400,"_33":14401},[],{"_35":2509,"_37":14402,"_39":2140,"_41":14403,"_65":14404,"_67":14405,"_69":68},"-m_akihR",{},[],"It is not clear what is the responsibility of a \"loader\". Does it fetch for related data like authors? Does it handle redirects or not?",{"_31":14407,"_33":14465},[14408,14419,14426,14433,14440,14447,14454],{"_31":14409,"_33":14410},[],{"_35":2509,"_37":14411,"_39":2140,"_41":14412,"_65":14413,"_67":14418,"_69":68},"P7NHjv7r",{},[14414],{"_35":2483,"_2607":14415,"_2610":14416,"_41":14417,"_69":68},[4810],[4746],{},"Author metadata (name, avatar for each document.authors)",{"_31":14420,"_33":14421},[],{"_35":2509,"_37":14422,"_39":2140,"_41":14423,"_65":14424,"_67":14425,"_69":68},"ts1nY4KO",{},[],"Breadcrumb navigation (metadata for each parent path)",{"_31":14427,"_33":14428},[],{"_35":2509,"_37":14429,"_39":2140,"_41":14430,"_65":14431,"_67":14432,"_69":68},"Z7TA5kBh",{},[],"Support documents (docs referenced via embeds/links in content)",{"_31":14434,"_33":14435},[],{"_35":2509,"_37":14436,"_39":2140,"_41":14437,"_65":14438,"_67":14439,"_69":68},"0i66W1RV",{},[],"Support queries (results from query blocks in content)",{"_31":14441,"_33":14442},[],{"_35":2509,"_37":14443,"_39":2140,"_41":14444,"_65":14445,"_67":14446,"_69":68},"kcCjb_77",{},[],"Directory results (children of home doc and current doc)",{"_31":14448,"_33":14449},[],{"_35":2509,"_37":14450,"_39":2140,"_41":14451,"_65":14452,"_67":14453,"_69":68},"La_DYmm0",{},[],"Home document (for site navigation header)",{"_31":14455,"_33":14456},[],{"_35":2509,"_37":14457,"_39":2140,"_41":14458,"_65":14459,"_67":14464,"_69":68},"KoJ03rxm",{},[14460],{"_35":2483,"_2607":14461,"_2610":14462,"_41":14463,"_69":68},[146],[985],{},"isLatest flag (compares current version to latest)",{"_35":2580,"_37":14466,"_39":2140,"_41":14467,"_65":14468,"_67":14473,"_69":68},"_jXyvbnS",{"_2582":2583},[14469],{"_35":2483,"_2607":14470,"_2610":14471,"_41":14472,"_69":68},[1365,2609],[4797,4781],{},"What web loadResource adds (via loadResourcePayload)",{"_31":14475,"_33":14516},[14476,14487,14498,14509],{"_31":14477,"_33":14478},[],{"_35":2509,"_37":14479,"_39":2140,"_41":14480,"_65":14481,"_67":14486,"_69":68},"r7Oi9iT_",{},[14482],{"_35":2483,"_2607":14483,"_2610":14484,"_41":14485,"_69":68},[1421],[1335],{},"Same name loadResource means different things (desktop returns raw, web returns with author metadata)",{"_31":14488,"_33":14489},[],{"_35":2509,"_37":14490,"_39":2140,"_41":14491,"_65":14492,"_67":14497,"_69":68},"HMwkR0N2",{},[14493],{"_35":2483,"_2607":14494,"_2610":14495,"_41":14496,"_69":68},[146,8503,5836],[2357,5987,6089],{},"createResourceLoader throws on error, but desktop's loadResource catches and returns not-found",{"_31":14499,"_33":14500},[],{"_35":2509,"_37":14501,"_39":2140,"_41":14502,"_65":14503,"_67":14508,"_69":68},"4W-dhDH6",{},[14504],{"_35":2483,"_2607":14505,"_2610":14506,"_41":14507,"_69":68},[4700,3886],[2724,5986],{},"Web has both getResource AND loadResource making duplicate GRPC calls",{"_31":14510,"_33":14511},[],{"_35":2509,"_37":14512,"_39":2140,"_41":14513,"_65":14514,"_67":14515,"_69":68},"hXqiWvpz",{},[],"No clear naming for abstraction levels",{"_35":2580,"_37":14517,"_39":2140,"_41":14518,"_65":14519,"_67":14520,"_69":68},"P5cTOwVh",{"_2582":2583},[],"Why It's Confusing",{"_35":2580,"_37":14522,"_39":2140,"_41":14523,"_65":14524,"_67":7153,"_69":68},"rb0tholt",{"_2582":239},[],{"_31":14526,"_33":14774},[14527,14534,14570,14603,14693],{"_31":14528,"_33":14529},[],{"_35":2509,"_37":14530,"_39":2140,"_41":14531,"_65":14532,"_67":14533,"_69":68},"XAFESVhh",{},[],"Note: this is more about \"re-organizing\" than \"refactoring\", so it shouldn't be a very dramatic change. But it should hopefully help us understand what functions are responsible for what.",{"_31":14535,"_33":14561},[14536,14554],{"_31":14537,"_33":14538},[],{"_35":2509,"_37":14539,"_39":2140,"_41":14540,"_65":14541,"_67":14553,"_69":68},"8P9FXpfG",{},[14542,14547],{"_35":2722,"_2607":14543,"_2610":14544,"_41":14546,"_69":68},[146,5835,4718,8459],[4700,6050,14545,5287],125,{},{"_35":2483,"_2607":14548,"_2610":14550,"_41":14552,"_69":68},[177,6492,14549,5838],163,[5477,2654,14551,9651],173,{},"What it does: GRPC call, parse response, return typed result Redirects: Returns {type: 'redirect', redirectTarget} Not found: Returns {type: 'not-found'} Returns: HMResource = document | comment | redirect | not-found",{"_31":14555,"_33":14556},[],{"_35":2483,"_37":14557,"_39":2140,"_41":14558,"_65":14559,"_67":14560,"_69":68},"zFIXMaXw",{"_2486":11038},[],"// Desktop, API endpoints, simple lookups\nconst resource = await fetchResource(id)\nif (resource.type === 'document') { /* use resource.document */ }\nif (resource.type === 'redirect') { /* caller decides what to do */ }\nif (resource.type === 'not-found') { /* caller decides what to do */ }\n",{"_35":2580,"_37":14562,"_39":2140,"_41":14563,"_65":14564,"_67":14569,"_69":68},"TTAr-6tv",{"_2582":239},[14565],{"_35":2483,"_2607":14566,"_2610":14567,"_41":14568,"_69":68},[146],[4700],{},"fetchResource (lowest level)",{"_31":14571,"_33":14594},[14572,14587],{"_31":14573,"_33":14574},[],{"_35":2509,"_37":14575,"_39":2140,"_41":14576,"_65":14577,"_67":14586,"_69":68},"SAPR28UK",{},[14578,14582],{"_35":2722,"_2607":14579,"_2610":14580,"_41":14581,"_69":68},[146,7891,7165,8020],[4700,8572,9276,5330],{},{"_35":2483,"_2607":14583,"_2610":14584,"_41":14585,"_69":68},[9095,6359,6566],[6219,8905,6011],{},"What it does: Fetches and follows redirects until final target Redirects: Follows automatically (recursive) Not found: Throws HMNotFoundError Returns: HMResolvedResource = document | comment (never redirect)",{"_31":14588,"_33":14589},[],{"_35":2483,"_37":14590,"_39":2140,"_41":14591,"_65":14592,"_67":14593,"_69":68},"IOzFIhYY",{"_2486":11038},[],"// When you need final target, don't care about redirect chain\nconst resource = await resolveResource(id)\n// resource.type is 'document' or 'comment', never 'redirect'\n",{"_35":2580,"_37":14595,"_39":2140,"_41":14596,"_65":14597,"_67":14602,"_69":68},"3goif2ck",{"_2582":239},[14598],{"_35":2483,"_2607":14599,"_2610":14600,"_41":14601,"_69":68},[146],[1892],{},"resolveResource (mid level)",{"_31":14604,"_33":14684},[14605,14669],{"_31":14606,"_33":14660},[14607,14614,14621,14628,14635,14642,14649],{"_31":14608,"_33":14609},[],{"_35":2509,"_37":14610,"_39":2140,"_41":14611,"_65":14612,"_67":14613,"_69":68},"FJs76hEt",{},[],"Author metadata (name, avatar for each author uid)",{"_31":14615,"_33":14616},[],{"_35":2509,"_37":14617,"_39":2140,"_41":14618,"_65":14619,"_67":14620,"_69":68},"_nY-MUK0",{},[],"Breadcrumb navigation (parent path titles)",{"_31":14622,"_33":14623},[],{"_35":2509,"_37":14624,"_39":2140,"_41":14625,"_65":14626,"_67":14627,"_69":68},"_G-SyvLY",{},[],"Support documents (embedded/referenced docs for rendering)",{"_31":14629,"_33":14630},[],{"_35":2509,"_37":14631,"_39":2140,"_41":14632,"_65":14633,"_67":14634,"_69":68},"OFg1-f7n",{},[],"Support queries (query block results)",{"_31":14636,"_33":14637},[],{"_35":2509,"_37":14638,"_39":2140,"_41":14639,"_65":14640,"_67":14641,"_69":68},"QQFLALkr",{},[],"Directory results (doc children for nav)",{"_31":14643,"_33":14644},[],{"_35":2509,"_37":14645,"_39":2140,"_41":14646,"_65":14647,"_67":14648,"_69":68},"CxhCnJGp",{},[],"Home document + directory (for site header nav)",{"_31":14650,"_33":14651},[],{"_35":2509,"_37":14652,"_39":2140,"_41":14653,"_65":14654,"_67":14659,"_69":68},"9p_a8eiF",{},[14655],{"_35":2483,"_2607":14656,"_2610":14657,"_41":14658,"_69":68},[146],[985],{},"isLatest flag",{"_35":2509,"_37":14661,"_39":2140,"_41":14662,"_65":14663,"_67":14668,"_69":68},"9BGmpND-",{"_2582":2583},[14664],{"_35":2722,"_2607":14665,"_2610":14666,"_41":14667,"_69":68},[146],[4700],{},"What it does: Resolves, triggers P2P discovery on not-found, adds:",{"_31":14670,"_33":14671},[],{"_35":2509,"_37":14672,"_39":2140,"_41":14673,"_65":14674,"_67":14683,"_69":68},"J_1ArpPJ",{},[14675,14679],{"_35":2722,"_2607":14676,"_2610":14677,"_41":14678,"_69":68},[146,6479,6319],[1421,4856,6045],{},{"_35":2483,"_2607":14680,"_2610":14681,"_41":14682,"_69":68},[5836],[5268],{},"Redirects: Follows automatically Not found: Triggers P2P discovery, retries Returns: WebResourcePayload",{"_35":2580,"_37":14685,"_39":2140,"_41":14686,"_65":14687,"_67":14692,"_69":68},"bGwFK1oU",{"_2582":239},[14688],{"_35":2483,"_2607":14689,"_2610":14690,"_41":14691,"_69":68},[146],[4855],{},"loadResource (web, highest level)",{"_31":14694,"_33":14765},[14695,14750],{"_31":14696,"_33":14737},[14697,14708,14719,14730],{"_31":14698,"_33":14699},[],{"_35":2509,"_37":14700,"_39":2140,"_41":14701,"_65":14702,"_67":14707,"_69":68},"7ApxdiqT",{},[14703],{"_35":2483,"_2607":14704,"_2610":14705,"_41":14706,"_69":68},[146],[4855],{},"homeMetadata (site name, icon, theme from account root)",{"_31":14709,"_33":14710},[],{"_35":2509,"_37":14711,"_39":2140,"_41":14712,"_65":14713,"_67":14718,"_69":68},"sAbW9oNl",{},[14714],{"_35":2483,"_2607":14715,"_2610":14716,"_41":14717,"_69":68},[146],[4855],{},"originHomeId (site root account id)",{"_31":14720,"_33":14721},[],{"_35":2509,"_37":14722,"_39":2140,"_41":14723,"_65":14724,"_67":14729,"_69":68},"nVVa_Bfl",{},[14725],{"_35":2483,"_2607":14726,"_2610":14727,"_41":14728,"_69":68},[146],[577],{},"origin (request origin URL)",{"_31":14731,"_33":14732},[],{"_35":2509,"_37":14733,"_39":2140,"_41":14734,"_65":14735,"_67":14736,"_69":68},"8z3M0wTN",{},[],"Error fallback (loads home doc even on error so header renders)",{"_35":2509,"_37":14738,"_39":2140,"_41":14739,"_65":14740,"_67":14749,"_69":68},"eecUpxsA",{"_2582":2583},[14741,14745],{"_35":2722,"_2607":14742,"_2610":14743,"_41":14744,"_69":68},[146],[4700],{},{"_35":2483,"_2607":14746,"_2610":14747,"_41":14748,"_69":68},[2357],[2609],{},"What it does: Calls loadResource + adds:",{"_31":14751,"_33":14752},[],{"_35":2509,"_37":14753,"_39":2140,"_41":14754,"_65":14755,"_67":14764,"_69":68},"dEvwNGJA",{},[14756,14760],{"_35":2722,"_2607":14757,"_2610":14758,"_41":14759,"_69":68},[146],[985],{},{"_35":2483,"_2607":14761,"_2610":14762,"_41":14763,"_69":68},[1365],[4780],{},"Returns: SiteDocumentPayload",{"_35":2580,"_37":14766,"_39":2140,"_41":14767,"_65":14768,"_67":14773,"_69":68},"7vBHLStd",{"_2582":239},[14769],{"_35":2483,"_2607":14770,"_2610":14771,"_41":14772,"_69":68},[146],[1111],{},"loadSiteResource (web, wraps loadResource)",{"_35":2580,"_37":14775,"_39":2140,"_41":14776,"_65":14777,"_67":14778,"_69":68},"fC208cUZ",{"_2582":239},[],"New Pattern: fetch → resolve → load",[74],"/tech-talks/resource-loading-organization",{"_86":2156},{},{"_92":2140,"_96":2154},{"_37":2137,"_104":53,"_54":14785,"_70":2140,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,2139],1778632074391,[158,2137,2140,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/resource-loading-organization\",\"bafy2bzacebewlsbwwc733rfg23wcnz6vgseuhp6cfuvppsf6flkqavher2xgq\",true]",{"_119":14790,"_156":14861,"_159":14862},{"_121":14791,"_141":44,"_142":14860,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":14792,"_37":14858},{"_28":14793,"_70":2162,"_71":53,"_72":14853,"_54":14854,"_80":2169,"_82":2169,"_84":14855,"_90":14856,"_92":2162,"_94":14857,"_98":99},[14794,14801,14823,14834,14846],{"_31":14795,"_33":14796},[],{"_35":2509,"_37":14797,"_39":2162,"_41":14798,"_65":14799,"_67":14800,"_69":68},"uOPL87My",{},[],"In our backend code I've seen a bunch of places where we compare the result of an expression with an input parameter/s.",{"_31":14802,"_33":14818},[14803,14811],{"_31":14804,"_33":14805},[],{"_35":2483,"_37":14806,"_39":2162,"_41":14807,"_65":14809,"_67":14810,"_69":68},"n1_t6w8O",{"_2486":14808},"sql",[],"SELECT\n id\nFROM public_keys\nWHERE hex(principal) = :principal LIMIT 1;",{"_31":14812,"_33":14813},[],{"_35":2483,"_37":14814,"_39":2162,"_41":14815,"_65":14816,"_67":14817,"_69":68},"rnD8Aiar",{"_2486":14808},[],"SELECT DISTINCT\n multihash,\n codec\nFROM blobs\nWHERE hex(multihash) IN (\n SELECT value from json_each(:mhash_json)\n)\nAND size > 0",{"_35":2509,"_37":14819,"_39":2162,"_41":14820,"_65":14821,"_67":14822,"_69":68},"O4BttVFb",{"_2582":239},[],"For example:",{"_31":14824,"_33":14825},[],{"_35":2509,"_37":14826,"_39":2162,"_41":14827,"_65":14828,"_67":14833,"_69":68},"DEE-HKih",{},[14829],{"_35":2483,"_2607":14830,"_2610":14831,"_41":14832,"_69":68},[3886,5330],[4688,6221],{},"In both of these queries the WHERE clause can't use an index, and will do a full table scan. This is because the index doesn't know the result of the hex() expression, so it can't compare the column value against the input parameter.",{"_31":14835,"_33":14836},[],{"_35":2509,"_37":14837,"_39":2162,"_41":14838,"_65":14839,"_67":14845,"_69":68},"TIHMi81A",{},[14840],{"_35":2483,"_2607":14841,"_2610":14842,"_41":14844,"_69":68},[711,5463],[5875,14843],177,{},"The solution for the first query is to do WHERE principal = unhex(:principal) and for the second one is to do WHERE multihash IN (SELECT unhex(value) FROM json_each(:mhash_json).",{"_31":14847,"_33":14848},[],{"_35":2509,"_37":14849,"_39":2162,"_41":14850,"_65":14851,"_67":14852,"_69":68},"QHFwP2nu",{},[],"So, instead of running an expression on all the rows in the table, we run the \"reverse\" expression to convert the input parameter to the same value as the column, which will let us use the index.",[185],"/tech-talks/sqlite-avoid-comparing-against-expressions",{"_86":2178},{},{"_92":2162,"_96":2176},{"_37":2159,"_104":53,"_54":14859,"_70":2162,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,2161],1778632074463,[158,2159,2162,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/sqlite-avoid-comparing-against-expressions\",\"bafy2bzacecmometxom6jy3blvvtlna5fbcvnzypu6oojunl56wcyt5hjwdpds\",true]",{"_119":14864,"_156":15089,"_159":15090},{"_121":14865,"_141":44,"_142":15088,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":14866,"_37":15086},{"_28":14867,"_70":2184,"_71":53,"_72":15080,"_54":15081,"_80":2192,"_82":15082,"_84":15083,"_90":15084,"_92":2193,"_94":15085,"_98":99},[14868,14890,14930,14980,15059],{"_31":14869,"_33":14881},[14870],{"_31":14871,"_33":14872},[],{"_35":2509,"_37":14873,"_39":2184,"_41":14874,"_65":14875,"_67":14880,"_69":68},"ptesScc6",{},[14876],{"_35":2722,"_2607":14877,"_2610":14878,"_41":14879,"_69":68},[5962],[9880],{},"Backend is taking over sync responsibility. New API: pushResourcesToPeer.\nFrontend (TS) will start calling it whenever a document-related change needs to be pushed to a peer.",{"_35":2580,"_37":14882,"_39":2193,"_41":14883,"_65":14884,"_67":14889,"_69":68},"W-M74EKa",{"_2582":239},[14885],{"_35":2722,"_2607":14886,"_2610":14887,"_41":14888,"_69":68},[146],[4855],{},"What changed",{"_31":14891,"_33":14921},[14892,14903,14914],{"_31":14893,"_33":14894},[],{"_35":2509,"_37":14895,"_39":2193,"_41":14896,"_65":14897,"_67":14902,"_69":68},"oSNCI7UJ",{},[14898],{"_35":2722,"_2607":14899,"_2610":14900,"_41":14901,"_69":68},[5262],[4746],{},"Frontend integration is straightforward; test on devnet after merge.",{"_31":14904,"_33":14905},[],{"_35":2509,"_37":14906,"_39":2193,"_41":14907,"_65":14908,"_67":14913,"_69":68},"_LQ-SrZa",{},[14909],{"_35":2722,"_2607":14910,"_2610":14911,"_41":14912,"_69":68},[146],[8503],{},"No DB migration. No mandatory protocol version bump.",{"_31":14915,"_33":14916},[],{"_35":2509,"_37":14917,"_39":2193,"_41":14918,"_65":14919,"_67":14920,"_69":68},"7J5hZn6a",{},[],"Reverting is easy.",{"_35":2580,"_37":14922,"_39":2193,"_41":14923,"_65":14924,"_67":14929,"_69":68},"CLWPflQr",{"_2582":2583},[14925],{"_35":2722,"_2607":14926,"_2610":14927,"_41":14928,"_69":68},[146],[4715],{},"Testing + rollout",{"_31":14931,"_33":14967},[14932,14939,14946,14953,14960],{"_31":14933,"_33":14934},[],{"_35":2509,"_37":14935,"_39":2193,"_41":14936,"_65":14937,"_67":14938,"_69":68},"DHsKwNMF",{},[],"New comment",{"_31":14940,"_33":14941},[],{"_35":2509,"_37":14942,"_39":2193,"_41":14943,"_65":14944,"_67":14945,"_69":68},"NXUtALrm",{},[],"User copies URL (share flow)",{"_31":14947,"_33":14948},[],{"_35":2509,"_37":14949,"_39":2193,"_41":14950,"_65":14951,"_67":14952,"_69":68},"4Z7L-P3J",{},[],"Document publish",{"_31":14954,"_33":14955},[],{"_35":2509,"_37":14956,"_39":2193,"_41":14957,"_65":14958,"_67":14959,"_69":68},"2QzZ2WrS",{},[],"Document delete",{"_31":14961,"_33":14962},[],{"_35":2509,"_37":14963,"_39":2193,"_41":14964,"_65":14965,"_67":14966,"_69":68},"2x0bbBLJ",{},[],"Document move+redirect (call for both old + new locations)",{"_35":2580,"_37":14968,"_39":2193,"_41":14969,"_65":14970,"_67":14979,"_69":68},"iEWvPwwo",{"_2582":2583},[14971,14975],{"_35":2722,"_2607":14972,"_2610":14973,"_41":14974,"_69":68},[146],[4780],{},{"_35":2483,"_2607":14976,"_2610":14977,"_41":14978,"_69":68},[4780],[2727],{},"When the frontend must call pushResourcesToPeer",{"_31":14981,"_33":15050},[14982,14993,15000],{"_31":14983,"_33":14984},[],{"_35":2509,"_37":14985,"_39":2193,"_41":14986,"_65":14987,"_67":14992,"_69":68},"3E21wsgT",{},[14988],{"_35":2722,"_2607":14989,"_2610":14990,"_41":14991,"_69":68},[5147],[2728],{},"Comments referencing other docs (A references B) require pushes for each referenced doc’s home server, so backlinks propagate correctly for self-hosters.",{"_31":14994,"_33":14995},[],{"_35":2509,"_37":14996,"_39":2193,"_41":14997,"_65":14998,"_67":14999,"_69":68},"edzzDAsW",{},[],"Same for doc-to-doc references.",{"_31":15001,"_33":15041},[15002,15009,15016,15023,15030],{"_31":15003,"_33":15004},[],{"_35":2509,"_37":15005,"_39":2193,"_41":15006,"_65":15007,"_67":15008,"_69":68},"OcytJbFz",{},[],"Alex half-jokes about backend auto-pushing all blobs, but it doesn’t know the target site, and frontend needs to show progress/spinner.",{"_31":15010,"_33":15011},[],{"_35":2509,"_37":15012,"_39":2193,"_41":15013,"_65":15014,"_67":15015,"_69":68},"KPFtLCJl",{},[],"periodic syncing does not support private docs, so push is even more important.",{"_31":15017,"_33":15018},[],{"_35":2509,"_37":15019,"_39":2193,"_41":15020,"_65":15021,"_67":15022,"_69":68},"fzJQeghx",{},[],"Worry: pushing to every referenced doc could become spammy.",{"_31":15024,"_33":15025},[],{"_35":2509,"_37":15026,"_39":2193,"_41":15027,"_65":15028,"_67":15029,"_69":68},"rYlpx2wn",{},[],"Counterpoint: self-hosters relying on federation/backlinks will break without this.",{"_31":15031,"_33":15032},[],{"_35":2509,"_37":15033,"_39":2193,"_41":15034,"_65":15035,"_67":15040,"_69":68},"JOJlLKZC",{},[15036],{"_35":7569,"_2607":15037,"_2610":15038,"_41":15039,"_69":68},[682],[6050],{},"Agreement: backlinks should only be expected within trust relationships (web-of-trust), not “the whole universe.”",{"_35":2580,"_37":15042,"_39":2193,"_41":15043,"_65":15044,"_67":15049,"_69":68},"e98TeJIf",{"_2582":2583},[15045],{"_35":2722,"_2607":15046,"_2610":15047,"_41":15048,"_69":68},[146],[5932],{},"Disagreements / nuances",{"_35":2580,"_37":15051,"_39":2193,"_41":15052,"_65":15053,"_67":15058,"_69":68},"RdfUPlAC",{"_2582":239},[15054],{"_35":2722,"_2607":15055,"_2610":15056,"_41":15057,"_69":68},[146],[4715],{},"Extra realization",{"_31":15060,"_33":15072},[15061],{"_31":15062,"_33":15063},[],{"_35":2509,"_37":15064,"_39":2193,"_41":15065,"_65":15066,"_67":15071,"_69":68},"5t8Ijoxm",{},[15067],{"_35":2722,"_2607":15068,"_2610":15069,"_41":15070,"_69":68},[1335],[7891],{},"Feature is doable but the TS side is more complex than expected because pushes must cover the primary document + all reference targets to keep federation/backlinks consistent for trusted self-hosted peers.",{"_35":2580,"_37":15073,"_39":2193,"_41":15074,"_65":15075,"_67":9699,"_69":68},"ELN8A7iH",{"_2582":239},[15076],{"_35":2722,"_2607":15077,"_2610":15078,"_41":15079,"_69":68},[146],[1421],{},[74],"/tech-talks/pushresourcestopeer-api-rollout","2025-11-20T11:19:12.945Z",{"_86":2206},{},{"_92":2193,"_96":2204},{"_37":2181,"_104":53,"_54":15087,"_70":2184,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,2183],1778632074403,[158,2181,2184,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/pushresourcestopeer-api-rollout\",\"bafy2bzacedp6smaulc5wzajs54digmhu5i5dwqwltxllza2nmpu5dowwzrrwg\",true]",{"_119":15092,"_156":15564,"_159":15565},{"_121":15093,"_141":44,"_142":15563,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":15094,"_37":15561},{"_28":15095,"_70":2212,"_71":53,"_72":15555,"_54":15556,"_80":2221,"_82":15557,"_84":15558,"_90":15559,"_92":2222,"_94":15560,"_98":99},[15096,15229,15290,15471,15513],{"_31":15097,"_33":15223},[15098,15116,15141,15166,15195],{"_31":15099,"_33":15111},[15100],{"_31":15101,"_33":15102},[],{"_35":2509,"_37":15103,"_39":2222,"_41":15104,"_65":15105,"_67":15110,"_69":68},"R_XB42PB",{},[15106],{"_35":2722,"_2607":15107,"_2610":15108,"_41":15109,"_69":68},[146],[4797],{},"8 physical CPU cores\n(Intel i7/i9, Xeon-W, AMD Ryzen 7/9, Threadripper-class optional)",{"_35":2580,"_37":15112,"_39":2222,"_41":15113,"_65":15114,"_67":15115,"_69":68},"wNtcU7Lf",{"_2582":2583},[],"CPU",{"_31":15117,"_33":15136},[15118,15129],{"_31":15119,"_33":15120},[],{"_35":2509,"_37":15121,"_39":2222,"_41":15122,"_65":15123,"_67":15128,"_69":68},"LM_4mz2d",{},[15124],{"_35":2722,"_2607":15125,"_2610":15126,"_41":15127,"_69":68},[146],[309],{},"32 GB DDR4/DDR5 RAM",{"_31":15130,"_33":15131},[],{"_35":2509,"_37":15132,"_39":2222,"_41":15133,"_65":15134,"_67":15135,"_69":68},"Be3bokA_",{},[],"ECC optional but recommended",{"_35":2580,"_37":15137,"_39":2222,"_41":15138,"_65":15139,"_67":15140,"_69":68},"3mnPsl40",{"_2582":2583},[],"Memory",{"_31":15142,"_33":15161},[15143,15154],{"_31":15144,"_33":15145},[],{"_35":2509,"_37":15146,"_39":2222,"_41":15147,"_65":15148,"_67":15153,"_69":68},"v60Vdgyz",{},[15149],{"_35":2722,"_2607":15150,"_2610":15151,"_41":15152,"_69":68},[146],[985],{},"1 TB SSD (SATA or NVMe; NVMe preferred but not required)",{"_31":15155,"_33":15156},[],{"_35":2509,"_37":15157,"_39":2222,"_41":15158,"_65":15159,"_67":15160,"_69":68},"p_ELzbDa",{},[],"No mechanical HDDs",{"_35":2580,"_37":15162,"_39":2222,"_41":15163,"_65":15164,"_67":15165,"_69":68},"RlemxgBz",{"_2582":2583},[],"Storage (SSD Only)",{"_31":15167,"_33":15190},[15168,15179],{"_31":15169,"_33":15170},[],{"_35":2509,"_37":15171,"_39":2222,"_41":15172,"_65":15173,"_67":15178,"_69":68},"BXzRt7UR",{},[15174],{"_35":2722,"_2607":15175,"_2610":15176,"_41":15177,"_69":68},[146],[4715],{},">=1 Gbps Ethernet",{"_31":15180,"_33":15181},[],{"_35":2509,"_37":15182,"_39":2222,"_41":15183,"_65":15184,"_67":15189,"_69":68},"nMxkolod",{},[15185],{"_35":2722,"_2607":15186,"_2610":15187,"_41":15188,"_69":68},[4855],[4810],{},"Support for static IPv4/IPv6 assignment",{"_35":2580,"_37":15191,"_39":2222,"_41":15192,"_65":15193,"_67":15194,"_69":68},"ryvTRFw-",{"_2582":2583},[],"Network Interface",{"_31":15196,"_33":15218},[15197,15204,15211],{"_31":15198,"_33":15199},[],{"_35":2509,"_37":15200,"_39":2222,"_41":15201,"_65":15202,"_67":15203,"_69":68},"KjMiDwYS",{},[],"Tower-workstation or small-form workstation",{"_31":15205,"_33":15206},[],{"_35":2509,"_37":15207,"_39":2222,"_41":15208,"_65":15209,"_67":15210,"_69":68},"Vjnh4CUc",{},[],"500–750W PSU",{"_31":15212,"_33":15213},[],{"_35":2509,"_37":15214,"_39":2222,"_41":15215,"_65":15216,"_67":15217,"_69":68},"xdaou085",{},[],"UPS recommended if not in a datacenter",{"_35":2580,"_37":15219,"_39":2222,"_41":15220,"_65":15221,"_67":15222,"_69":68},"TZwyz3OG",{"_2582":2583},[],"Power / Form Factor",{"_35":2580,"_37":15224,"_39":15225,"_41":15226,"_65":15227,"_67":15228,"_69":68},"G0J4Px28","bafy2bzaceca6ywi7v523pug5a4pcbugpssmu2r5msxke6hlhr3dqw44ly5x7q",{"_2582":239},[],"1. Hardware Requirements",{"_31":15230,"_33":15285},[15231,15256],{"_31":15232,"_33":15251},[15233,15244],{"_31":15234,"_33":15235},[],{"_35":2509,"_37":15236,"_39":2222,"_41":15237,"_65":15238,"_67":15243,"_69":68},"52mcQdJJ",{},[15239],{"_35":2722,"_2607":15240,"_2610":15241,"_41":15242,"_69":68},[146],[4715],{},"Ubuntu Server LTS (24.04)",{"_31":15245,"_33":15246},[],{"_35":2509,"_37":15247,"_39":2222,"_41":15248,"_65":15249,"_67":15250,"_69":68},"2dgyrh6f",{},[],"Minimal installation + SSH enabled",{"_35":2580,"_37":15252,"_39":2222,"_41":15253,"_65":15254,"_67":15255,"_69":68},"YiPZkoMK",{"_2582":2583},[],"OS",{"_31":15257,"_33":15280},[15258,15269],{"_31":15259,"_33":15260},[],{"_35":2509,"_37":15261,"_39":2222,"_41":15262,"_65":15263,"_67":15268,"_69":68},"vicrD991",{},[15264],{"_35":2722,"_2607":15265,"_2610":15266,"_41":15267,"_69":68},[146],[4700],{},"Docker Engine",{"_31":15270,"_33":15271},[],{"_35":2509,"_37":15272,"_39":2222,"_41":15273,"_65":15274,"_67":15279,"_69":68},"PmR30cUW",{},[15275],{"_35":2722,"_2607":15276,"_2610":15277,"_41":15278,"_69":68},[146],[309],{},"Docker Compose (v2)",{"_35":2580,"_37":15281,"_39":2222,"_41":15282,"_65":15283,"_67":15284,"_69":68},"j1f4Y9Cr",{"_2582":2583},[],"Container Runtime",{"_35":2580,"_37":15286,"_39":15225,"_41":15287,"_65":15288,"_67":15289,"_69":68},"fOdN2Yze",{"_2582":239},[],"2. Operating System & Software",{"_31":15291,"_33":15466},[15292,15317,15386],{"_31":15293,"_33":15312},[15294,15305],{"_31":15295,"_33":15296},[],{"_35":2509,"_37":15297,"_39":2222,"_41":15298,"_65":15299,"_67":15304,"_69":68},"tBXQ60qn",{},[15300],{"_35":2722,"_2607":15301,"_2610":15302,"_41":15303,"_69":68},[309],[4780],{},"They must assign a static IP for the workstation server.",{"_31":15306,"_33":15307},[],{"_35":2509,"_37":15308,"_39":2222,"_41":15309,"_65":15310,"_67":15311,"_69":68},"XJnvFq5i",{},[],"The IP must be reachable from inside their network;",{"_35":2580,"_37":15313,"_39":2222,"_41":15314,"_65":15315,"_67":15316,"_69":68},"6__yNmwS",{"_2582":2583},[],"Static IP Address",{"_31":15318,"_33":15381},[15319,15352],{"_31":15320,"_33":15347},[15321,15336],{"_31":15322,"_33":15323},[],{"_35":2509,"_37":15324,"_39":2222,"_41":15325,"_65":15326,"_67":15335,"_69":68},"BgKlQbGz",{},[15327,15331],{"_35":2722,"_2607":15328,"_2610":15329,"_41":15330,"_69":68},[1038],[3821],{},{"_35":2483,"_2607":15332,"_2610":15333,"_41":15334,"_69":68},[309,2609],[6232,8503],{},"A subdomain (e.g., seed.ucm.es, seed.sheffield.ac.uk)",{"_31":15337,"_33":15338},[],{"_35":2509,"_37":15339,"_39":2222,"_41":15340,"_65":15341,"_67":15346,"_69":68},"0C1ipH1b",{},[15342],{"_35":2722,"_2607":15343,"_2610":15344,"_41":15345,"_69":68},[4855],[2357],{},"A dedicated A record pointed to the server’s static IP",{"_35":2509,"_37":15348,"_39":2222,"_41":15349,"_65":15350,"_67":15351,"_69":68},"15tmQGAk",{"_2582":2583},[],"They must provide:",{"_31":15353,"_33":15376},[15354,15365],{"_31":15355,"_33":15356},[],{"_35":2509,"_37":15357,"_39":2222,"_41":15358,"_65":15359,"_67":15364,"_69":68},"dCgFYKc3",{},[15360],{"_35":2722,"_2607":15361,"_2610":15362,"_41":15363,"_69":68},[146],[985],{},"A record → IPv4 of the server",{"_31":15366,"_33":15367},[],{"_35":2509,"_37":15368,"_39":2222,"_41":15369,"_65":15370,"_67":15375,"_69":68},"W_HUCxN2",{},[15371],{"_35":2722,"_2607":15372,"_2610":15373,"_41":15374,"_69":68},[146],[740],{},"CNAME ",{"_35":2509,"_37":15377,"_39":2222,"_41":15378,"_65":15379,"_67":15380,"_69":68},"YmO81JE1",{"_2582":2583},[],"They must be able to add the DNS records:",{"_35":2580,"_37":15382,"_39":2222,"_41":15383,"_65":15384,"_67":15385,"_69":68},"57sjJnJ6",{"_2582":2583},[],"Domain Name / Subdomain",{"_31":15387,"_33":15461},[15388,15399,15406],{"_31":15389,"_33":15390},[],{"_35":2509,"_37":15391,"_39":2222,"_41":15392,"_65":15393,"_67":15398,"_69":68},"XZ9KUcc-",{},[15394],{"_35":2722,"_2607":15395,"_2610":15396,"_41":15397,"_69":68},[4855],[4856],{},"Seed uses a non-standard ports: 56000-56002.",{"_31":15400,"_33":15401},[],{"_35":2509,"_37":15402,"_39":2222,"_41":15403,"_65":15404,"_67":15405,"_69":68},"aSSqLORC",{},[],"They must allow the following:",{"_31":15407,"_33":15452},[15408],{"_31":15409,"_33":15443},[15410,15421,15432],{"_31":15411,"_33":15412},[],{"_35":2509,"_37":15413,"_39":2222,"_41":15414,"_65":15415,"_67":15420,"_69":68},"oc_41XgX",{},[15416],{"_35":2722,"_2607":15417,"_2610":15418,"_41":15419,"_69":68},[985],[309],{},"TCP/UDP 56000-56002 → required by Seed (primary application port)",{"_31":15422,"_33":15423},[],{"_35":2509,"_37":15424,"_39":2222,"_41":15425,"_65":15426,"_67":15431,"_69":68},"GK_VhUhh",{},[15427],{"_35":2722,"_2607":15428,"_2610":15429,"_41":15430,"_69":68},[1257],[577],{},"TCP 22 → SSH administration (should be limited to IT staff only)",{"_31":15433,"_33":15434},[],{"_35":2509,"_37":15435,"_39":2222,"_41":15436,"_65":15437,"_67":15442,"_69":68},"bykGnkNU",{},[15438],{"_35":2722,"_2607":15439,"_2610":15440,"_41":15441,"_69":68},[1257],[1421],{},"TCP 80/443 → if using HTTP/HTTPS proxying in front of port 56000",{"_35":2509,"_37":15444,"_39":2222,"_41":15445,"_65":15446,"_67":15451,"_69":68},"KBupVCBs",{"_2582":2583},[15447],{"_35":2722,"_2607":15448,"_2610":15449,"_41":15450,"_69":68},[146],[985],{},"Inbound:",{"_35":2509,"_37":15453,"_39":2222,"_41":15454,"_65":15455,"_67":15460,"_69":68},"cbg-u9WI",{"_2582":2583},[15456],{"_35":2722,"_2607":15457,"_2610":15458,"_41":15459,"_69":68},[146],[5932],{},"Firewall / Router Rules",{"_35":2580,"_37":15462,"_39":15225,"_41":15463,"_65":15464,"_67":15465,"_69":68},"AzM46nEW",{"_2582":239},[],"Port Requirements",{"_35":2580,"_37":15467,"_39":15225,"_41":15468,"_65":15469,"_67":15470,"_69":68},"kYMxi_ci",{"_2582":239},[],"3. Networking & Domain Requirements",{"_31":15472,"_33":15508},[15473,15480,15487,15494,15501],{"_31":15474,"_33":15475},[],{"_35":2509,"_37":15476,"_39":2222,"_41":15477,"_65":15478,"_67":15479,"_69":68},"ybroolxx",{},[],"Runs full Seed application inside Docker containers",{"_31":15481,"_33":15482},[],{"_35":2509,"_37":15483,"_39":2222,"_41":15484,"_65":15485,"_67":15486,"_69":68},"WClYkwkv",{},[],"SSD ensures fast I/O for logs and database",{"_31":15488,"_33":15489},[],{"_35":2509,"_37":15490,"_39":2222,"_41":15491,"_65":15492,"_67":15493,"_69":68},"fjsPB4lN",{},[],"Suitable for ~20–200 concurrent users",{"_31":15495,"_33":15496},[],{"_35":2509,"_37":15497,"_39":2222,"_41":15498,"_65":15499,"_67":15500,"_69":68},"7BArPARf",{},[],"No GPU needed",{"_31":15502,"_33":15503},[],{"_35":2509,"_37":15504,"_39":2222,"_41":15505,"_65":15506,"_67":15507,"_69":68},"_L_T0Sgr",{},[],"Works entirely on a single workstation-class machine",{"_35":2580,"_37":15509,"_39":2222,"_41":15510,"_65":15511,"_67":15512,"_69":68},"YefWLTu5",{"_2582":2583},[],"4. Application Hosting Requirements",{"_31":15514,"_33":15550},[15515,15536,15543],{"_31":15516,"_33":15531},[15517,15524],{"_31":15518,"_33":15519},[],{"_35":2509,"_37":15520,"_39":2222,"_41":15521,"_65":15522,"_67":15523,"_69":68},"qu3NEYUn",{},[],"Network share, or",{"_31":15525,"_33":15526},[],{"_35":2509,"_37":15527,"_39":2222,"_41":15528,"_65":15529,"_67":15530,"_69":68},"8LGyi2fV",{},[],"External server",{"_35":2509,"_37":15532,"_39":2222,"_41":15533,"_65":15534,"_67":15535,"_69":68},"aKedrIVA",{"_2582":2583},[],"Daily or weekly backing up Seed data (DB + media) to:",{"_31":15537,"_33":15538},[],{"_35":2509,"_37":15539,"_39":2222,"_41":15540,"_65":15541,"_67":15542,"_69":68},"F8HQX_Jn",{},[],"Monthly OS updates via package manager",{"_31":15544,"_33":15545},[],{"_35":2509,"_37":15546,"_39":2222,"_41":15547,"_65":15548,"_67":15549,"_69":68},"v2Ggy4FB",{},[],"Optional: basic monitoring",{"_35":2580,"_37":15551,"_39":2222,"_41":15552,"_65":15553,"_67":15554,"_69":68},"hsjg_QKJ",{"_2582":2583},[],"5. Backup & Maintenance",[75,77],"/tech-talks/server-specs","2025-11-06T17:38:59.930Z",{"_86":2231},{},{"_92":2222,"_96":2229},{"_37":2209,"_104":53,"_54":15562,"_70":2212,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,2211],1778632074387,[158,2209,2212,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/server-specs\",\"bafy2bzacedsdj7fi4asf43uex75ozh2gkpjpu462e3ppehp2r2wojvw5w7dqs\",true]",{"_119":15567,"_156":15850,"_159":15851},{"_121":15568,"_141":44,"_142":15849,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":15569,"_37":15847},{"_28":15570,"_70":2237,"_71":53,"_72":15842,"_54":15843,"_80":2244,"_82":2244,"_84":15844,"_90":15845,"_92":2237,"_94":15846,"_98":99},[15571,15578,15594,15627,15678,15685,15718,15769,15776,15783],{"_31":15572,"_33":15573},[],{"_35":2509,"_37":15574,"_39":2237,"_41":15575,"_65":15576,"_67":15577,"_69":68},"uUMVgjx9",{},[],"Written by chatGPT5",{"_31":15579,"_33":15580},[],{"_35":2509,"_37":15581,"_39":2237,"_41":15582,"_65":15583,"_67":15593,"_69":68},"Sll_veAW",{},[15584,15588],{"_35":2722,"_2607":15585,"_2610":15586,"_41":15587,"_69":68},[5219],[5946],{},{"_35":206,"_2607":15589,"_2610":15590,"_41":15591,"_69":15592},[6072],[5477],{},"http://fetch.No","You’re trying to let Remix loaders and React Query (RQ) “own” the same data. That splits authority and guarantees flicker, stale props, and double-fetches. Pick a boss.",{"_31":15595,"_33":15622},[15596,15611],{"_31":15597,"_33":15598},[],{"_35":2509,"_37":15599,"_39":2237,"_41":15600,"_65":15601,"_67":15610,"_69":68},"iyhn5MDP",{},[15602,15606],{"_35":2722,"_2607":15603,"_2610":15604,"_41":15605,"_69":68},[146,4784],[4855,177],{},{"_35":2483,"_2607":15607,"_2610":15608,"_41":15609,"_69":68},[4701],[4716],{},"Remix loader: pushes JSON into useLoaderData(). Remix decides when to revalidate (navigations, mutations, focus, etc.).",{"_31":15612,"_33":15613},[],{"_35":2509,"_37":15614,"_39":2237,"_41":15615,"_65":15616,"_67":15621,"_69":68},"DL9r2Bjf",{},[15617],{"_35":2722,"_2607":15618,"_2610":15619,"_41":15620,"_69":68},[146,2357,2609,485,4746,5998],[3821,3566,711,5962,5147,8457],{},"React Query: owns a cache, with timestamps, staleTime, invalidations, and optimistic updates.",{"_35":2580,"_37":15623,"_39":2237,"_41":15624,"_65":15625,"_67":15626,"_69":68},"S-WZDKWn",{"_2582":2583},[],"Two data models, one UI",{"_31":15628,"_33":15673},[15629,15640,15651,15662],{"_31":15630,"_33":15631},[],{"_35":2509,"_37":15632,"_39":2237,"_41":15633,"_65":15634,"_67":15639,"_69":68},"NULgNIAl",{},[15635],{"_35":2722,"_2607":15636,"_2610":15637,"_41":15638,"_69":68},[146],[3821],{},"Stale props: loader data freezes at navigation time while RQ mutates underneath.",{"_31":15641,"_33":15642},[],{"_35":2509,"_37":15643,"_39":2237,"_41":15644,"_65":15645,"_67":15650,"_69":68},"GziPkxbw",{},[15646],{"_35":2722,"_2607":15647,"_2610":15648,"_41":15649,"_69":68},[146],[4855],{},"Double fetch: loader runs on navigation; RQ refetches on mount because your query is “stale.”",{"_31":15652,"_33":15653},[],{"_35":2509,"_37":15654,"_39":2237,"_41":15655,"_65":15656,"_67":15661,"_69":68},"1xvNMs_L",{},[15657],{"_35":2722,"_2607":15658,"_2610":15659,"_41":15660,"_69":68},[146],[4715],{},"Conflicted writes: Remix revalidation repaints old loader data right after an RQ mutation unless you micromanage.",{"_31":15663,"_33":15664},[],{"_35":2509,"_37":15665,"_39":2237,"_41":15666,"_65":15667,"_67":15672,"_69":68},"KLduAINM",{},[15668],{"_35":2722,"_2607":15669,"_2610":15670,"_41":15671,"_69":68},[146],[1892],{},"Mental overhead: two invalidation systems, two lifecycles, zero fun.",{"_35":2509,"_37":15674,"_39":2237,"_41":15675,"_65":15676,"_67":15677,"_69":68},"42MmqEtO",{"_2582":2583},[],"Run both on the same slice and you get:",{"_31":15679,"_33":15680},[],{"_35":2580,"_37":15681,"_39":2237,"_41":15682,"_65":15683,"_67":15684,"_69":68},"l7kV3ZDf",{},[],"The workable pattern",{"_31":15686,"_33":15709},[15687,15698],{"_31":15688,"_33":15689},[],{"_35":2509,"_37":15690,"_39":2237,"_41":15691,"_65":15692,"_67":15697,"_69":68},"GhaF1Kp5",{},[15693],{"_35":2483,"_2607":15694,"_2610":15695,"_41":15696,"_69":68},[146],[8503],{},"export function shouldRevalidate() { return false; } (or conditionally).",{"_31":15699,"_33":15700},[],{"_35":2509,"_37":15701,"_39":2237,"_41":15702,"_65":15703,"_67":15708,"_69":68},"4QwbxC1r",{},[15704],{"_35":2722,"_2607":15705,"_2610":15706,"_41":15707,"_69":68},[5934],[711],{},"Or move volatile bits into resource routes and fetch them via RQ, keeping parent route loaders stable.",{"_35":2509,"_37":15710,"_39":2237,"_41":15711,"_65":15712,"_67":15717,"_69":68},"3KEB0_hv",{"_2582":2583},[15713],{"_35":2722,"_2607":15714,"_2610":15715,"_41":15716,"_69":68},[6232],[4781],{},"If you insist on SSR + RQ, do SSR hydration with RQ and stop reading loader data in the component.",{"_31":15719,"_33":15764},[15720,15731,15742,15753],{"_31":15721,"_33":15722},[],{"_35":2509,"_37":15723,"_39":2237,"_41":15724,"_65":15725,"_67":15730,"_69":68},"7SCofR9d",{},[15726],{"_35":2483,"_2607":15727,"_2610":15728,"_41":15729,"_69":68},[1306,2727],[1335,4746],{},"Mixing useLoaderData() into UI that also calls useQuery for the same entity.",{"_31":15732,"_33":15733},[],{"_35":2509,"_37":15734,"_39":2237,"_41":15735,"_65":15736,"_67":15741,"_69":68},"OCjC84U0",{},[15737],{"_35":2483,"_2607":15738,"_2610":15739,"_41":15740,"_69":68},[1421],[4808],{},"Different queryKeys server vs client → hydration mismatch → double fetch.",{"_31":15743,"_33":15744},[],{"_35":2509,"_37":15745,"_39":2237,"_41":15746,"_65":15747,"_67":15752,"_69":68},"vxFWx5cR",{},[15748],{"_35":2483,"_2607":15749,"_2610":15750,"_41":15751,"_69":68},[172],[4855],{},"No staleTime → instant refetch on mount even though you just dehydrated.",{"_31":15754,"_33":15755},[],{"_35":2509,"_37":15756,"_39":2237,"_41":15757,"_65":15758,"_67":15763,"_69":68},"g49pUXsZ",{},[15759],{"_35":2483,"_2607":15760,"_2610":15761,"_41":15762,"_69":68},[577],[4855],{},"Using /actions for mutations while RQ also invalidates → dueling revalidations.",{"_35":2580,"_37":15765,"_39":2237,"_41":15766,"_65":15767,"_67":15768,"_69":68},"-NWQYQuX",{"_2582":2583},[],"Common faceplants",{"_31":15770,"_33":15771},[],{"_35":2580,"_37":15772,"_39":2237,"_41":15773,"_65":15774,"_67":15775,"_69":68},"IZrt37t8",{},[],"Why RQ wins post-hydrate",{"_31":15777,"_33":15778},[],{"_35":2509,"_37":15779,"_39":2237,"_41":15780,"_65":15781,"_67":15782,"_69":68},"uMtIoyeg",{},[],"Remix gives you server data and routing. RQ gives you cache, retries, dedupe, mutations, optimistic UI, background refresh. After first paint, you want RQ in charge—or you’re herding cats.",{"_31":15784,"_33":15837},[15785,15800,15811,15822],{"_31":15786,"_33":15787},[],{"_35":2509,"_37":15788,"_39":2237,"_41":15789,"_65":15790,"_67":15799,"_69":68},"STXiHWaS",{},[15791,15795],{"_35":2722,"_2607":15792,"_2610":15793,"_41":15794,"_69":68},[146],[5932],{},{"_35":2483,"_2607":15796,"_2610":15797,"_41":15798,"_69":68},[4712,6000],[5284,5461],{},"RQ-first (recommended)\nDehydrate in loader, read with useQuery only, mutations via RQ, shouldRevalidate=false. Clean, predictable.",{"_31":15801,"_33":15802},[],{"_35":2509,"_37":15803,"_39":2237,"_41":15804,"_65":15805,"_67":15810,"_69":68},"OV7THMOV",{},[15806],{"_35":2722,"_2607":15807,"_2610":15808,"_41":15809,"_69":68},[146],[4855],{},"Remix-first\nUse loaders/fetchers for reads/mutations; drop RQ for that domain. Less power, fewer moving parts.",{"_31":15812,"_33":15813},[],{"_35":2509,"_37":15814,"_39":2237,"_41":15815,"_65":15816,"_67":15821,"_69":68},"bBAmi6UE",{},[15817],{"_35":2722,"_2607":15818,"_2610":15819,"_41":15820,"_69":68},[146,5733],[840,2725],{},"Islands split\nStable parent via Remix loader; volatile lists/resources via resource routes + RQ. Invalidate only those keys. Minimal blast radius.",{"_31":15823,"_33":15824},[],{"_35":2509,"_37":15825,"_39":2237,"_41":15826,"_65":15827,"_67":15836,"_69":68},"P-XRgWiM",{},[15828,15832],{"_35":2722,"_2607":15829,"_2610":15830,"_41":15831,"_69":68},[146,4730],[4808,6199],{},{"_35":2483,"_2607":15833,"_2610":15834,"_41":15835,"_69":68},[4716,4784],[6356,6089],{},"Hybrid with truce\nKeep both, but on mutation: invalidateQueries() and revalidator.revalidate(). Accept extra fetches and complexity. Your call.",{"_35":2580,"_37":15838,"_39":2237,"_41":15839,"_65":15840,"_67":15841,"_69":68},"IZ-dKjFB",{"_2582":2878},[],"Options (pick one, don’t waffle)",[74],"/tech-talks/remix-react-query-why-your-data-looks-drunk",{"_86":2257},{},{"_92":2237,"_96":2255},{"_37":2234,"_104":53,"_54":15848,"_70":2237,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,2236],1778632074379,[158,2234,2237,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/remix-react-query-why-your-data-looks-drunk\",\"bafy2bzacec6j5fjl66wu3weplmaaittfxent2dpcndi3tcvbzqblimorxqqh2\",true]",{"_119":15853,"_156":16853,"_159":16854},{"_121":15854,"_141":44,"_142":7089,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":15855,"_37":16851},{"_28":15856,"_70":2263,"_71":53,"_72":16845,"_54":16846,"_80":2271,"_82":16847,"_84":16848,"_90":16849,"_92":2272,"_94":16850,"_98":99},[15857,15864,15904,15968,16080,16105,16309,16385,16463,16512,16592,16673,16752,16803],{"_31":15858,"_33":15859},[],{"_35":2509,"_37":15860,"_39":2272,"_41":15861,"_65":15862,"_67":15863,"_69":68},"2AQxEzt2",{},[],"Text fragment rendering displays specific portions of document text (defined by character ranges) with all inline embeds resolved to their actual content.",{"_31":15865,"_33":15898},[15866],{"_31":15867,"_33":15889},[15868,15875,15882],{"_31":15869,"_33":15870},[],{"_35":2509,"_37":15871,"_39":2272,"_41":15872,"_65":15873,"_67":15874,"_69":68},"7Sfbdmy3",{},[],"Extract characters 10-50 from the block's text",{"_31":15876,"_33":15877},[],{"_35":2509,"_37":15878,"_39":2272,"_41":15879,"_65":15880,"_67":15881,"_69":68},"pU9EmXDA",{},[],"Resolve any inline embeds within that range",{"_31":15883,"_33":15884},[],{"_35":2509,"_37":15885,"_39":2272,"_41":15886,"_65":15887,"_67":15888,"_69":68},"pTd7tWCx",{},[],"Display the resulting text with embed names",{"_35":2509,"_37":15890,"_39":2272,"_41":15891,"_65":15892,"_67":15897,"_69":68},"p4bS3k9R",{"_2582":2878},[15893],{"_35":2483,"_2607":15894,"_2610":15895,"_41":15896,"_69":68},[4746],[6071],{},"When embedding a document fragment with a range (e.g., hm://account/doc#blockId[10:50]), the system needs to:",{"_35":2580,"_37":15899,"_39":15900,"_41":15901,"_65":15902,"_67":15903,"_69":68},"G0HJUcvf","bafy2bzacecoypfxa5xumes5igxbeqsxvrrfzadhvxj3o2o5dd5eegalwen6ow",{"_2582":239},[],"Overview",{"_31":15905,"_33":15963},[15906,15942],{"_31":15907,"_33":15933},[15908,15915,15926],{"_31":15909,"_33":15910},[],{"_35":2509,"_37":15911,"_39":2272,"_41":15912,"_65":15913,"_67":15914,"_69":68},"ID_nVwnC",{},[],"Counts actual text characters",{"_31":15916,"_33":15917},[],{"_35":2509,"_37":15918,"_39":2272,"_41":15919,"_65":15920,"_67":15925,"_69":68},"Zte1v8Xz",{},[15921],{"_35":2722,"_2607":15922,"_2610":15923,"_41":15924,"_69":68},[146],[985],{},"Excludes invisible inline embed markers (U+FEFF)",{"_31":15927,"_33":15928},[],{"_35":2509,"_37":15929,"_39":2272,"_41":15930,"_65":15931,"_67":15932,"_69":68},"Lhmt73y1",{},[],"Uses unicode code points (not UTF-16 code units)",{"_35":2509,"_37":15934,"_39":2272,"_41":15935,"_65":15936,"_67":15941,"_69":68},"okSe950P",{"_2582":2583},[15937],{"_35":2722,"_2607":15938,"_2610":15939,"_41":15940,"_69":68},[9880],[5836],{},"Fragment ranges are specified using unicode code point positions in the original text, which:",{"_31":15943,"_33":15958},[15944,15951],{"_31":15945,"_33":15946},[],{"_35":2509,"_37":15947,"_39":2272,"_41":15948,"_65":15949,"_67":15950,"_69":68},"2N4petb7",{},[],"Inline embeds are replaced with document names",{"_31":15952,"_33":15953},[],{"_35":2509,"_37":15954,"_39":2272,"_41":15955,"_65":15956,"_67":15957,"_69":68},"Yj-V3U9C",{},[],"Character positions map correctly to the original range",{"_35":2509,"_37":15959,"_39":2272,"_41":15960,"_65":15961,"_67":15962,"_69":68},"CTKzdWnQ",{"_2582":2583},[],"But we want to display text where:",{"_35":2580,"_37":15964,"_39":15900,"_41":15965,"_65":15966,"_67":15967,"_69":68},"LwEpNjAZ",{"_2582":239},[],"The Challenge",{"_31":15969,"_33":16075},[15970,15988],{"_31":15971,"_33":15983},[15972],{"_31":15973,"_33":15974},[],{"_35":2509,"_37":15975,"_39":2272,"_41":15976,"_65":15977,"_67":15982,"_69":68},"sPGkongJ",{},[15978],{"_35":2483,"_2607":15979,"_2610":15980,"_41":15981,"_69":68},[146],[682],{},"frontend/packages/ui/src/document-content.tsx",{"_35":2580,"_37":15984,"_39":15900,"_41":15985,"_65":15986,"_67":15987,"_69":68},"V2oxMfcS",{"_2582":239},[],"Component Location",{"_31":15989,"_33":16070},[15990,15997],{"_31":15991,"_33":15992},[],{"_35":2483,"_37":15993,"_39":2272,"_41":15994,"_65":15995,"_67":15996,"_69":68},"PD6OxYD_",{"_2486":11038},[],"function FragmentText({\n documentId,\n blockRef,\n start,\n end,\n}: {\n documentId: UnpackedHypermediaId\n blockRef: string\n start: number\n end: number\n})\n",{"_31":15998,"_33":16061},[15999,16021,16043],{"_31":16000,"_33":16008},[16001],{"_31":16002,"_33":16003},[],{"_35":2483,"_37":16004,"_39":2272,"_41":16005,"_65":16006,"_67":16007,"_69":68},"WXIBSnsF",{"_2486":11038},[],"getDocumentText(\n {...documentId, blockRef, blockRange: null},\n {lineBreaks: false, resolveInlineEmbeds: true}\n)\n",{"_35":2509,"_37":16009,"_39":2272,"_41":16010,"_65":16011,"_67":16020,"_69":68},"g_xug3Tw",{"_2582":239},[16012,16016],{"_35":2722,"_2607":16013,"_2610":16014,"_41":16015,"_69":68},[146],[1892],{},{"_35":2483,"_2607":16017,"_2610":16018,"_41":16019,"_69":68},[1335,4744],[4337,5836],{},"Fetch Full Text: Call getDocumentText with the blockRef and resolveInlineEmbeds: true",{"_31":16022,"_33":16030},[16023],{"_31":16024,"_33":16025},[],{"_35":2483,"_37":16026,"_39":2272,"_41":16027,"_65":16028,"_67":16029,"_69":68},"pU3qHOXg",{"_2486":11038},[],"const codePoints = Array.from(fullText)\nconst fragment = codePoints.slice(start, end).join('')\n",{"_35":2509,"_37":16031,"_39":2272,"_41":16032,"_65":16033,"_67":16042,"_69":68},"wVk_knmG",{"_2582":239},[16034,16038],{"_35":2722,"_2607":16035,"_2610":16036,"_41":16037,"_69":68},[146],[1111],{},{"_35":2483,"_2607":16039,"_2610":16040,"_41":16041,"_69":68},[1335],[4688],{},"Extract Fragment: Use Array.from() to properly handle unicode code points",{"_31":16044,"_33":16052},[16045],{"_31":16046,"_33":16047},[],{"_35":2483,"_37":16048,"_39":2272,"_41":16049,"_65":16050,"_67":16051,"_69":68},"iWcIY3M_",{"_2486":11038},[],"{fragment}\n",{"_35":2509,"_37":16053,"_39":2272,"_41":16054,"_65":16055,"_67":16060,"_69":68},"z207SaG1",{"_2582":239},[16056],{"_35":2722,"_2607":16057,"_2610":16058,"_41":16059,"_69":68},[146],[1306],{},"Display: Render the extracted text",{"_35":2509,"_37":16062,"_39":2272,"_41":16063,"_65":16064,"_67":16069,"_69":68},"im6tjwrr",{"_2582":2878},[16065],{"_35":2722,"_2607":16066,"_2610":16067,"_41":16068,"_69":68},[146],[985],{},"Process:",{"_35":2580,"_37":16071,"_39":15900,"_41":16072,"_65":16073,"_67":16074,"_69":68},"63mv-pMB",{"_2582":239},[],"How It Works",{"_35":2580,"_37":16076,"_39":15900,"_41":16077,"_65":16078,"_67":16079,"_69":68},"7zjcmUp5",{"_2582":239},[],"Solution: FragmentText Component",{"_31":16081,"_33":16100},[16082,16093],{"_31":16083,"_33":16084},[],{"_35":2509,"_37":16085,"_39":2272,"_41":16086,"_65":16087,"_67":16092,"_69":68},"ckffVPlq",{},[16088],{"_35":2483,"_2607":16089,"_2610":16090,"_41":16091,"_69":68},[1257],[1111],{},"The ContentEmbed component detects text fragments and renders them appropriately:",{"_31":16094,"_33":16095},[],{"_35":2483,"_37":16096,"_39":2272,"_41":16097,"_65":16098,"_67":16099,"_69":68},"qvKjS-q1",{"_2486":11038},[],"// Check if this is a text fragment (blockRef with start/end range)\nconst isTextFragment =\n props.blockRef &&\n props.blockRange &&\n 'start' in props.blockRange &&\n 'end' in props.blockRange\n\nif (isTextFragment && props.blockRef && props.blockRange &&\n 'start' in props.blockRange && 'end' in props.blockRange) {\n // Render as plain text with resolved embeds\n content = (\n \n )\n} else {\n // Normal block rendering\n // ...\n}\n",{"_35":2580,"_37":16101,"_39":15900,"_41":16102,"_65":16103,"_67":16104,"_69":68},"JEAUgjgt",{"_2582":239},[],"Integration with ContentEmbed",{"_31":16106,"_33":16304},[16107,16162,16235],{"_31":16108,"_33":16157},[16109,16120,16127,16142],{"_31":16110,"_33":16111},[],{"_35":2509,"_37":16112,"_39":2272,"_41":16113,"_65":16114,"_67":16119,"_69":68},"YCqkIZTx",{},[16115],{"_35":2722,"_2607":16116,"_2610":16117,"_41":16118,"_69":68},[146],[2357],{},"Original block text:",{"_31":16121,"_33":16122},[],{"_35":2483,"_37":16123,"_39":2272,"_41":16124,"_65":16125,"_67":16126,"_69":68},"1hskuso6",{"_2486":68},[],"\"Hello world, this is a test paragraph with some content.\"\n",{"_31":16128,"_33":16129},[],{"_35":2509,"_37":16130,"_39":2272,"_41":16131,"_65":16132,"_67":16141,"_69":68},"o6BezkUf",{},[16133,16137],{"_35":2722,"_2607":16134,"_2610":16135,"_41":16136,"_69":68},[146],[985],{},{"_35":2483,"_2607":16138,"_2610":16139,"_41":16140,"_69":68},[1421],[2724],{},"Fragment: #blockId[0:11]",{"_31":16143,"_33":16144},[],{"_35":2509,"_37":16145,"_39":2272,"_41":16146,"_65":16147,"_67":16156,"_69":68},"BMzIlh8L",{},[16148,16152],{"_35":2722,"_2607":16149,"_2610":16150,"_41":16151,"_69":68},[146],[577],{},{"_35":2483,"_2607":16153,"_2610":16154,"_41":16155,"_69":68},[985],[4797],{},"Result: \"Hello world\"",{"_35":2580,"_37":16158,"_39":15900,"_41":16159,"_65":16160,"_67":16161,"_69":68},"iDz8Q6OO",{"_2582":239},[],"Example 1: Simple Text Fragment",{"_31":16163,"_33":16230},[16164,16175,16182,16193,16200,16215],{"_31":16165,"_33":16166},[],{"_35":2509,"_37":16167,"_39":2272,"_41":16168,"_65":16169,"_67":16174,"_69":68},"9S6ZH_mk",{},[16170],{"_35":2722,"_2607":16171,"_2610":16172,"_41":16173,"_69":68},[146],[682],{},"Original block text (with invisible markers):",{"_31":16176,"_33":16177},[],{"_35":2483,"_37":16178,"_39":2272,"_41":16179,"_65":16180,"_67":16181,"_69":68},"7zNe8eXa",{"_2486":68},[],"\"Check out \\uFEFF post about AI!\"\n// Position: 0-9, [10 = embed], 11-25\n",{"_31":16183,"_33":16184},[],{"_35":2509,"_37":16185,"_39":2272,"_41":16186,"_65":16187,"_67":16192,"_69":68},"aURuOQn2",{},[16188],{"_35":2722,"_2607":16189,"_2610":16190,"_41":16191,"_69":68},[146],[5934],{},"With inline embed resolved:",{"_31":16194,"_33":16195},[],{"_35":2483,"_37":16196,"_39":2272,"_41":16197,"_65":16198,"_67":16199,"_69":68},"2J1ilyYt",{"_2486":68},[],"\"Check out @Alice's Guide post about AI!\"\n",{"_31":16201,"_33":16202},[],{"_35":2509,"_37":16203,"_39":2272,"_41":16204,"_65":16205,"_67":16214,"_69":68},"kaO539LI",{},[16206,16210],{"_35":2722,"_2607":16207,"_2610":16208,"_41":16209,"_69":68},[146],[985],{},{"_35":2483,"_2607":16211,"_2610":16212,"_41":16213,"_69":68},[1421],[2724],{},"Fragment: #blockId[0:20]",{"_31":16216,"_33":16217},[],{"_35":2509,"_37":16218,"_39":2272,"_41":16219,"_65":16220,"_67":16229,"_69":68},"Zr55I9qf",{},[16221,16225],{"_35":2722,"_2607":16222,"_2610":16223,"_41":16224,"_69":68},[146],[577],{},{"_35":2483,"_2607":16226,"_2610":16227,"_41":16228,"_69":68},[985],[5946],{},"Result: \"Check out @Alice's Guide pos\" (first 20 unicode code points)",{"_35":2580,"_37":16231,"_39":15900,"_41":16232,"_65":16233,"_67":16234,"_69":68},"a5fPxHJY",{"_2582":239},[],"Example 2: Fragment with Inline Embed",{"_31":16236,"_33":16299},[16237,16248,16255,16266,16273,16288],{"_31":16238,"_33":16239},[],{"_35":2509,"_37":16240,"_39":2272,"_41":16241,"_65":16242,"_67":16247,"_69":68},"dk1c5DlJ",{},[16243],{"_35":2722,"_2607":16244,"_2610":16245,"_41":16246,"_69":68},[146],[840],{},"Original text:",{"_31":16249,"_33":16250},[],{"_35":2483,"_37":16251,"_39":2272,"_41":16252,"_65":16253,"_67":16254,"_69":68},"oTceVd84",{"_2486":68},[],"\"Read \\uFEFF and \\uFEFF for more info\"\n// [Read ][embed1][ and ][embed2][ for more info]\n",{"_31":16256,"_33":16257},[],{"_35":2509,"_37":16258,"_39":2272,"_41":16259,"_65":16260,"_67":16265,"_69":68},"_OH0sp5H",{},[16261],{"_35":2722,"_2607":16262,"_2610":16263,"_41":16264,"_69":68},[146],[4797],{},"With embeds resolved:",{"_31":16267,"_33":16268},[],{"_35":2483,"_37":16269,"_39":2272,"_41":16270,"_65":16271,"_67":16272,"_69":68},"gNCFEUnh",{"_2486":68},[],"\"Read @Getting Started and @Advanced Topics for more info\"\n",{"_31":16274,"_33":16275},[],{"_35":2509,"_37":16276,"_39":2272,"_41":16277,"_65":16278,"_67":16287,"_69":68},"cCggRTwW",{},[16279,16283],{"_35":2722,"_2607":16280,"_2610":16281,"_41":16282,"_69":68},[146],[985],{},{"_35":2483,"_2607":16284,"_2610":16285,"_41":16286,"_69":68},[1421],[2724],{},"Fragment: #blockId[0:25]",{"_31":16289,"_33":16290},[],{"_35":2509,"_37":16291,"_39":2272,"_41":16292,"_65":16293,"_67":16298,"_69":68},"yBQMmBNe",{},[16294],{"_35":2722,"_2607":16295,"_2610":16296,"_41":16297,"_69":68},[146],[577],{},"Result: First 25 code points with both embed names included",{"_35":2580,"_37":16300,"_39":15900,"_41":16301,"_65":16302,"_67":16303,"_69":68},"NI2C9wms",{"_2582":239},[],"Example 3: Multiple Inline Embeds",{"_35":2580,"_37":16305,"_39":15900,"_41":16306,"_65":16307,"_67":16308,"_69":68},"sRnlocyj",{"_2582":239},[],"Example Scenarios",{"_31":16310,"_33":16380},[16311,16359],{"_31":16312,"_33":16354},[16313,16324,16339],{"_31":16314,"_33":16315},[],{"_35":2509,"_37":16316,"_39":2272,"_41":16317,"_65":16318,"_67":16323,"_69":68},"c0oJqPcs",{},[16319],{"_35":2722,"_2607":16320,"_2610":16321,"_41":16322,"_69":68},[146],[4808],{},"Original Positions: Defined in the blockRange, count actual text excluding embed markers",{"_31":16325,"_33":16326},[],{"_35":2509,"_37":16327,"_39":2272,"_41":16328,"_65":16329,"_67":16338,"_69":68},"OF0qe0zF",{},[16330,16334],{"_35":2722,"_2607":16331,"_2610":16332,"_41":16333,"_69":68},[146],[4700],{},{"_35":2483,"_2607":16335,"_2610":16336,"_41":16337,"_69":68},[4797],[5219],{},"Resolved Text: After documentToText processes it, embeds become their document names",{"_31":16340,"_33":16341},[],{"_35":2509,"_37":16342,"_39":2272,"_41":16343,"_65":16344,"_67":16353,"_69":68},"-4ijt-qu",{},[16345,16349],{"_35":2722,"_2607":16346,"_2610":16347,"_41":16348,"_69":68},[146],[309],{},{"_35":2483,"_2607":16350,"_2610":16351,"_41":16352,"_69":68},[3566],[4337],{},"Unicode Code Points: Use Array.from() to properly count multi-byte characters",{"_35":2580,"_37":16355,"_39":2272,"_41":16356,"_65":16357,"_67":16358,"_69":68},"09rTCjd6",{"_2582":2878},[],"Key Concepts",{"_31":16360,"_33":16375},[16361,16368],{"_31":16362,"_33":16363},[],{"_35":2509,"_37":16364,"_39":2272,"_41":16365,"_65":16366,"_67":16367,"_69":68},"NZv8UlOi",{},[],"JavaScript strings are UTF-16 encoded. Emojis and special characters may use multiple UTF-16 code units:",{"_31":16369,"_33":16370},[],{"_35":2483,"_37":16371,"_39":2272,"_41":16372,"_65":16373,"_67":16374,"_69":68},"ivBOxmnW",{"_2486":11038},[],"// Wrong: UTF-16 code units\n\"Hello 👋\".length // 7 (emoji uses 2 code units)\n\n// Correct: Unicode code points\nArray.from(\"Hello 👋\").length // 6 (emoji is 1 code point)\n",{"_35":2580,"_37":16376,"_39":15900,"_41":16377,"_65":16378,"_67":16379,"_69":68},"RnfUWiwR",{"_2582":239},[],"Why Array.from()?",{"_35":2580,"_37":16381,"_39":15900,"_41":16382,"_65":16383,"_67":16384,"_69":68},"gsg9HI2J",{"_2582":239},[],"Character Position Mapping",{"_31":16386,"_33":16458},[16387,16394,16426],{"_31":16388,"_33":16389},[],{"_35":2509,"_37":16390,"_39":2272,"_41":16391,"_65":16392,"_67":16393,"_69":68},"9Afg8sIB",{},[],"Fragment rendering works seamlessly in both desktop and web:",{"_31":16395,"_33":16421},[16396,16407,16414],{"_31":16397,"_33":16398},[],{"_35":2509,"_37":16399,"_39":2272,"_41":16400,"_65":16401,"_67":16406,"_69":68},"mOIYkNDb",{},[16402],{"_35":2483,"_2607":16403,"_2610":16404,"_41":16405,"_69":68},[1306],[4715],{},"Direct grpcClient access",{"_31":16408,"_33":16409},[],{"_35":2509,"_37":16410,"_39":2272,"_41":16411,"_65":16412,"_67":16413,"_69":68},"AilfdYeZ",{},[],"Synchronous document fetching",{"_31":16415,"_33":16416},[],{"_35":2509,"_37":16417,"_39":2272,"_41":16418,"_65":16419,"_67":16420,"_69":68},"tyPDwr0h",{},[],"Immediate text resolution",{"_35":2580,"_37":16422,"_39":2272,"_41":16423,"_65":16424,"_67":16425,"_69":68},"jMn41UV1",{"_2582":2583},[],"Desktop",{"_31":16427,"_33":16453},[16428,16439,16446],{"_31":16429,"_33":16430},[],{"_35":2509,"_37":16431,"_39":2272,"_41":16432,"_65":16433,"_67":16438,"_69":68},"nC1TkfZp",{},[16434],{"_35":2483,"_2607":16435,"_2610":16436,"_41":16437,"_69":68},[4715],[5946],{},"Server-side API: /hm/api/document-text",{"_31":16440,"_33":16441},[],{"_35":2509,"_37":16442,"_39":2272,"_41":16443,"_65":16444,"_67":16445,"_69":68},"xr_sMT22",{},[],"Accepts blockRef in URL parameters",{"_31":16447,"_33":16448},[],{"_35":2509,"_37":16449,"_39":2272,"_41":16450,"_65":16451,"_67":16452,"_69":68},"sAkzpS7s",{},[],"Returns resolved text via JSON",{"_35":2580,"_37":16454,"_39":2272,"_41":16455,"_65":16456,"_67":16457,"_69":68},"QPLTiQqh",{"_2582":2583},[],"Web",{"_35":2580,"_37":16459,"_39":15900,"_41":16460,"_65":16461,"_67":16462,"_69":68},"w9r8e0e-",{"_2582":239},[],"API Endpoint Support",{"_31":16464,"_33":16507},[16465,16479,16493],{"_31":16466,"_33":16474},[16467],{"_31":16468,"_33":16469},[],{"_35":2483,"_37":16470,"_39":2272,"_41":16471,"_65":16472,"_67":16473,"_69":68},"VvCaHE4p",{"_2486":11038},[],"if (loading) {\n return (\n \n \n \n )\n}\n",{"_35":2580,"_37":16475,"_39":15900,"_41":16476,"_65":16477,"_67":16478,"_69":68},"wI01-Han",{"_2582":239},[],"Loading",{"_31":16480,"_33":16488},[16481],{"_31":16482,"_33":16483},[],{"_35":2483,"_37":16484,"_39":2272,"_41":16485,"_65":16486,"_67":16487,"_69":68},"8EJtU0zB",{"_2486":11038},[],"if (error) {\n return \n}\n",{"_35":2580,"_37":16489,"_39":15900,"_41":16490,"_65":16491,"_67":16492,"_69":68},"ew5oXSYq",{"_2582":239},[],"Error",{"_31":16494,"_33":16502},[16495],{"_31":16496,"_33":16497},[],{"_35":2483,"_37":16498,"_39":2272,"_41":16499,"_65":16500,"_67":16501,"_69":68},"8Yj_wH_F",{"_2486":11038},[],"return (\n \n {text}\n \n)\n",{"_35":2580,"_37":16503,"_39":15900,"_41":16504,"_65":16505,"_67":16506,"_69":68},"8IuxlY98",{"_2582":239},[],"Success",{"_35":2580,"_37":16508,"_39":15900,"_41":16509,"_65":16510,"_67":16511,"_69":68},"oqtJOgPb",{"_2582":239},[],"Component States",{"_31":16513,"_33":16587},[16514],{"_31":16515,"_33":16582},[16516,16527,16542],{"_31":16517,"_33":16518},[],{"_35":2509,"_37":16519,"_39":2272,"_41":16520,"_65":16521,"_67":16526,"_69":68},"hrkmNvEU",{},[16522],{"_35":2722,"_2607":16523,"_2610":16524,"_41":16525,"_69":68},[146],[577],{},"Editor: User selects text range in a block",{"_31":16528,"_33":16529},[],{"_35":2509,"_37":16530,"_39":2272,"_41":16531,"_65":16532,"_67":16541,"_69":68},"KF1l79hD",{},[16533,16537],{"_35":2722,"_2607":16534,"_2610":16535,"_41":16536,"_69":68},[146],[4700],{},{"_35":2483,"_2607":16538,"_2610":16539,"_41":16540,"_69":68},[5146],[6050],{},"Link Creation: System creates link like hm://account/doc#blockId[10:50]",{"_31":16543,"_33":16573},[16544,16555,16566],{"_31":16545,"_33":16546},[],{"_35":2509,"_37":16547,"_39":2272,"_41":16548,"_65":16549,"_67":16554,"_69":68},"VQmz8yke",{},[16550],{"_35":2483,"_2607":16551,"_2610":16552,"_41":16553,"_69":68},[146],[4855],{},"ContentEmbed detects the range",{"_31":16556,"_33":16557},[],{"_35":2509,"_37":16558,"_39":2272,"_41":16559,"_65":16560,"_67":16565,"_69":68},"eBiiW6iw",{},[16561],{"_35":2483,"_2607":16562,"_2610":16563,"_41":16564,"_69":68},[146],[4855],{},"FragmentText fetches and extracts text",{"_31":16567,"_33":16568},[],{"_35":2509,"_37":16569,"_39":2272,"_41":16570,"_65":16571,"_67":16572,"_69":68},"eGZ7xnSR",{},[],"Displays resolved fragment",{"_35":2509,"_37":16574,"_39":2272,"_41":16575,"_65":16576,"_67":16581,"_69":68},"MyM8caFB",{"_2582":2583},[16577],{"_35":2722,"_2607":16578,"_2610":16579,"_41":16580,"_69":68},[146],[1365],{},"Rendering:",{"_35":2509,"_37":16583,"_39":2272,"_41":16584,"_65":16585,"_67":16586,"_69":68},"SOdRhrBN",{"_2582":2878},[],"When a user creates an embed with a text range:",{"_35":2580,"_37":16588,"_39":15900,"_41":16589,"_65":16590,"_67":16591,"_69":68},"wRi7E2mW",{"_2582":239},[],"Usage in Embeds",{"_31":16593,"_33":16668},[16594,16626,16654],{"_31":16595,"_33":16621},[16596,16607,16614],{"_31":16597,"_33":16598},[],{"_35":2509,"_37":16599,"_39":2272,"_41":16600,"_65":16601,"_67":16606,"_69":68},"St53QBel",{},[16602],{"_35":2483,"_2607":16603,"_2610":16604,"_41":16605,"_69":68},[4715],[2609],{},"Consider caching getDocumentText results",{"_31":16608,"_33":16609},[],{"_35":2509,"_37":16610,"_39":2272,"_41":16611,"_65":16612,"_67":16613,"_69":68},"chKSyATF",{},[],"Fragment extraction is fast (O(n) where n = text length)",{"_31":16615,"_33":16616},[],{"_35":2509,"_37":16617,"_39":2272,"_41":16618,"_65":16619,"_67":16620,"_69":68},"QDysylVq",{},[],"Network requests may be slow on web",{"_35":2580,"_37":16622,"_39":2272,"_41":16623,"_65":16624,"_67":16625,"_69":68},"20FIkrPQ",{"_2582":2583},[],"Caching",{"_31":16627,"_33":16649},[16628,16635,16642],{"_31":16629,"_33":16630},[],{"_35":2509,"_37":16631,"_39":2272,"_41":16632,"_65":16633,"_67":16634,"_69":68},"pb4xKmmy",{},[],"Only fetch when fragment changes",{"_31":16636,"_33":16637},[],{"_35":2509,"_37":16638,"_39":2272,"_41":16639,"_65":16640,"_67":16641,"_69":68},"Nhoihj4_",{},[],"UseEffect dependencies include all ID components",{"_31":16643,"_33":16644},[],{"_35":2509,"_37":16645,"_39":2272,"_41":16646,"_65":16647,"_67":16648,"_69":68},"yCXUAt11",{},[],"Loading state prevents UI jank",{"_35":2580,"_37":16650,"_39":2272,"_41":16651,"_65":16652,"_67":16653,"_69":68},"Y7JF9krF",{"_2582":2583},[],"Optimization",{"_31":16655,"_33":16663},[16656],{"_31":16657,"_33":16658},[],{"_35":2483,"_37":16659,"_39":2272,"_41":16660,"_65":16661,"_67":16662,"_69":68},"HNtX3FKP",{"_2486":11038},[],"useEffect(() => {\n // ...\n}, [\n getDocumentText,\n documentId.uid,\n documentId.path?.join('/'),\n documentId.version,\n blockRef,\n start,\n end\n])\n",{"_35":2580,"_37":16664,"_39":15900,"_41":16665,"_65":16666,"_67":16667,"_69":68},"WeyIFqay",{"_2582":239},[],"Dependencies",{"_35":2580,"_37":16669,"_39":15900,"_41":16670,"_65":16671,"_67":16672,"_69":68},"kYLADXMg",{"_2582":239},[],"Performance Considerations",{"_31":16674,"_33":16748},[16675],{"_31":16676,"_33":16743},[16677,16688,16699,16710,16721,16732],{"_31":16678,"_33":16679},[],{"_35":2509,"_37":16680,"_39":2272,"_41":16681,"_65":16682,"_67":16687,"_69":68},"3vc5z7_P",{},[16683],{"_35":2722,"_2607":16684,"_2610":16685,"_41":16686,"_69":68},[146],[3566],{},"Basic fragment extraction: Simple text without embeds",{"_31":16689,"_33":16690},[],{"_35":2509,"_37":16691,"_39":2272,"_41":16692,"_65":16693,"_67":16698,"_69":68},"ijDLC0ov",{},[16694],{"_35":2722,"_2607":16695,"_2610":16696,"_41":16697,"_69":68},[146],[309],{},"Single inline embed: Fragment includes embed name",{"_31":16700,"_33":16701},[],{"_35":2509,"_37":16702,"_39":2272,"_41":16703,"_65":16704,"_67":16709,"_69":68},"lRc9Gfdv",{},[16705],{"_35":2722,"_2607":16706,"_2610":16707,"_41":16708,"_69":68},[146],[1335],{},"Multiple inline embeds: All embeds resolved correctly",{"_31":16711,"_33":16712},[],{"_35":2509,"_37":16713,"_39":2272,"_41":16714,"_65":16715,"_67":16720,"_69":68},"d-_byl6F",{},[16716],{"_35":2722,"_2607":16717,"_2610":16718,"_41":16719,"_69":68},[146],[1111],{},"Unicode handling: Emojis and special characters",{"_31":16722,"_33":16723},[],{"_35":2509,"_37":16724,"_39":2272,"_41":16725,"_65":16726,"_67":16731,"_69":68},"tlIcCaYP",{},[16727],{"_35":2722,"_2607":16728,"_2610":16729,"_41":16730,"_69":68},[146],[840],{},"Boundary cases: start=0, end=text.length",{"_31":16733,"_33":16734},[],{"_35":2509,"_37":16735,"_39":2272,"_41":16736,"_65":16737,"_67":16742,"_69":68},"-9wfpL5z",{},[16738],{"_35":2722,"_2607":16739,"_2610":16740,"_41":16741,"_69":68},[146],[840],{},"Error handling: Missing blocks, network errors",{"_35":2509,"_37":16744,"_39":2272,"_41":16745,"_65":16746,"_67":16747,"_69":68},"UldeaHf_",{"_2582":2878},[],"Test scenarios to verify:",{"_35":2580,"_37":16749,"_39":15900,"_41":16750,"_65":16751,"_67":12234,"_69":68},"zZsnUvpO",{"_2582":239},[],{"_31":16753,"_33":16798},[16754,16765,16776,16787],{"_31":16755,"_33":16756},[],{"_35":2509,"_37":16757,"_39":2272,"_41":16758,"_65":16759,"_67":16764,"_69":68},"4cxhkyzz",{},[16760],{"_35":2483,"_2607":16761,"_2610":16762,"_41":16763,"_69":68},[146],[682],{},"frontend/packages/ui/src/document-content.tsx - FragmentText component",{"_31":16766,"_33":16767},[],{"_35":2509,"_37":16768,"_39":2272,"_41":16769,"_65":16770,"_67":16775,"_69":68},"gl7dYRlG",{},[16771],{"_35":2483,"_2607":16772,"_2610":16773,"_41":16774,"_69":68},[146],[6141],{},"frontend/packages/shared/src/document-to-text.ts - Text resolution",{"_31":16777,"_33":16778},[],{"_35":2509,"_37":16779,"_39":2272,"_41":16780,"_65":16781,"_67":16786,"_69":68},"_H22v0RU",{},[16782],{"_35":2483,"_2607":16783,"_2610":16784,"_41":16785,"_69":68},[146],[4712],{},"frontend/packages/shared/src/document-content-types.ts - Type definitions",{"_31":16788,"_33":16789},[],{"_35":2509,"_37":16790,"_39":2272,"_41":16791,"_65":16792,"_67":16797,"_69":68},"ETnm5hgI",{},[16793],{"_35":2483,"_2607":16794,"_2610":16795,"_41":16796,"_69":68},[146],[5962],{},"frontend/apps/web/app/routes/hm.api.document-text.tsx - Web API",{"_35":2580,"_37":16799,"_39":2272,"_41":16800,"_65":16801,"_67":16802,"_69":68},"gutU_mQb",{"_2582":2583},[],"Related Files",{"_31":16804,"_33":16840},[16805,16816,16828],{"_31":16806,"_33":16807},[],{"_35":2509,"_37":16808,"_39":2263,"_41":16809,"_65":16810,"_67":2346,"_69":68},"pXje3YS5",{},[16811],{"_35":206,"_2607":16812,"_2610":16813,"_41":16814,"_69":16815},[146],[3566],{},"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/document-to-text-function?v=bafy2bzacecdcvfpp3eagebhnu4eolfvyon2pfvp2ykl4qnidggatkabnsumem&l",{"_31":16817,"_33":16818},[],{"_35":2509,"_37":16819,"_39":2263,"_41":16820,"_65":16821,"_67":16827,"_69":68},"5tQqsyUo",{},[16822],{"_35":206,"_2607":16823,"_2610":16824,"_41":16825,"_69":16826},[146],[1111],{},"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/linking?v=bafy2bzacedtevim3q4ybtoohumxjpvniscrxbpvd3hscofjobyls2c5djysug&l","Document Linking",{"_31":16829,"_33":16830},[],{"_35":2509,"_37":16831,"_39":2263,"_41":16832,"_65":16833,"_67":16839,"_69":68},"fhWZxoA7",{},[16834],{"_35":206,"_2607":16835,"_2610":16836,"_41":16837,"_69":16838},[146],[1892],{},"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/document-block-types?v=bafy2bzaceb424vzlgrj45dfv6kfsb4oaatln62bni2cirlgv5m2wpalye22m6&l","Document Blocks",{"_35":2580,"_37":16841,"_39":2272,"_41":16842,"_65":16843,"_67":16844,"_69":68},"nKkEq5Vt",{"_2582":2583},[],"Related Documentation",[78],"/tech-talks/text-fragment-rendering","2025-10-24T16:15:06.504Z",{"_86":2281},{},{"_92":2272,"_96":2279},{"_37":2260,"_104":53,"_54":16852,"_70":2263,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,2262],[158,2260,2263,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/text-fragment-rendering\",\"bafy2bzaced7d25yqqvto2ouca5cc5oe3kesdp27ow5nwy76gpwh6idflmnwla\",true]",{"_119":16856,"_156":17163,"_159":17164},{"_121":16857,"_141":44,"_142":17162,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":16858,"_37":17160},{"_28":16859,"_70":2287,"_71":53,"_72":17155,"_54":17156,"_80":2293,"_82":2293,"_84":17157,"_90":17158,"_92":2287,"_94":17159,"_98":99},[16860,16871,16878,16925,16968,17012,17111,17132],{"_31":16861,"_33":16862},[],{"_35":2509,"_37":16863,"_39":2287,"_41":16864,"_65":16865,"_67":16870,"_69":68},"XgHevQBb",{},[16866],{"_35":2483,"_2607":16867,"_2610":16868,"_41":16869,"_69":68},[4701],[2883],{},"HyperDocs links, prefixed with hm://, take the following form:",{"_31":16872,"_33":16873},[],{"_35":2483,"_37":16874,"_39":2287,"_41":16875,"_65":16876,"_67":16877,"_69":68},"essbTKio",{"_2486":68},[],"hm://d/DOCUMENT_ID?v=VERSION_REF#BLOCK_REF",{"_31":16879,"_33":16920},[16880],{"_31":16881,"_33":16915},[16882,16893,16904],{"_31":16883,"_33":16884},[],{"_35":2509,"_37":16885,"_39":2287,"_41":16886,"_65":16887,"_67":16892,"_69":68},"Al5NGTyL",{},[16888],{"_35":2483,"_2607":16889,"_2610":16890,"_41":16891,"_69":68},[146],[740],{},"hm:// - the HyperDocs URL scheme",{"_31":16894,"_33":16895},[],{"_35":2509,"_37":16896,"_39":2287,"_41":16897,"_65":16898,"_67":16903,"_69":68},"DEg9l2CZ",{},[16899],{"_35":2483,"_2607":16900,"_2610":16901,"_41":16902,"_69":68},[146],[1038],{},"d/ - the Entity Type ID",{"_31":16905,"_33":16906},[],{"_35":2509,"_37":16907,"_39":2287,"_41":16908,"_65":16909,"_67":16914,"_69":68},"pPAOzLB4",{},[16910],{"_35":2483,"_2607":16911,"_2610":16912,"_41":16913,"_69":68},[146],[3821],{},"DOCUMENT_ID - the ID of the Document to reference",{"_35":2509,"_37":16916,"_39":2287,"_41":16917,"_65":16918,"_67":16919,"_69":68},"Zuh31CWJ",{"_2582":2583},[],"The following portion is required:",{"_35":2580,"_37":16921,"_39":2287,"_41":16922,"_65":16923,"_67":16924,"_69":68},"lYVoP4tT",{"_2582":239},[],"Entity References",{"_31":16926,"_33":16963},[16927,16956],{"_31":16928,"_33":16951},[16929,16940],{"_31":16930,"_33":16931},[],{"_35":2509,"_37":16932,"_39":2287,"_41":16933,"_65":16934,"_67":16939,"_69":68},"SGp-lqeB",{},[16935],{"_35":2483,"_2607":16936,"_2610":16937,"_41":16938,"_69":68},[146],[44],{},"d - Document Entity",{"_31":16941,"_33":16942},[],{"_35":2509,"_37":16943,"_39":2287,"_41":16944,"_65":16945,"_67":16950,"_69":68},"j_nyO_3y",{},[16946],{"_35":2483,"_2607":16947,"_2610":16948,"_41":16949,"_69":68},[146],[44],{},"a - Account Entity",{"_35":2509,"_37":16952,"_39":2287,"_41":16953,"_65":16954,"_67":16955,"_69":68},"esGm0USw",{"_2582":2583},[],"The following are valid entity type identifiers",{"_31":16957,"_33":16958},[],{"_35":2509,"_37":16959,"_39":2287,"_41":16960,"_65":16961,"_67":16962,"_69":68},"-GFR2q1q",{},[],"Additional types and conventions are reserved for future use",{"_35":2580,"_37":16964,"_39":2287,"_41":16965,"_65":16966,"_67":16967,"_69":68},"8Y8B5qhJ",{"_2582":239},[],"Entity Type ID",{"_31":16969,"_33":17007},[16970],{"_31":16971,"_33":16994},[16972,16983],{"_31":16973,"_33":16974},[],{"_35":2509,"_37":16975,"_39":2287,"_41":16976,"_65":16977,"_67":16982,"_69":68},"xUphBKab",{},[16978],{"_35":2483,"_2607":16979,"_2610":16980,"_41":16981,"_69":68},[146],[172],{},"?v= - optional query parameter designating the version ref",{"_31":16984,"_33":16985},[],{"_35":2509,"_37":16986,"_39":2287,"_41":16987,"_65":16988,"_67":16993,"_69":68},"Egl-sK97",{},[16989],{"_35":2483,"_2607":16990,"_2610":16991,"_41":16992,"_69":68},[146,5477],[3821,4718],{},"VERSION_REF - the CID(s) of the EntityChange that represent an exact version of the Entity, separated by periods (.)",{"_35":2509,"_37":16995,"_39":2287,"_41":16996,"_65":16997,"_67":17006,"_69":68},"Sl4r_UYU",{"_2582":2583},[16998,17002],{"_35":2483,"_2607":16999,"_2610":17000,"_41":17001,"_69":68},[4715],[5219],{},{"_35":2722,"_2607":17003,"_2610":17004,"_41":17005,"_69":68},[6378],[5468],{},"A link with only hm://d/DOCUMENT_ID is valid, but the entity may change over time. To link to the exact version of an Entity, include:",{"_35":2580,"_37":17008,"_39":2287,"_41":17009,"_65":17010,"_67":17011,"_69":68},"5wtWdXY9",{"_2582":239},[],"Version References",{"_31":17013,"_33":17106},[17014,17026,17055,17066],{"_31":17015,"_33":17016},[],{"_35":2509,"_37":17017,"_39":2287,"_41":17018,"_65":17019,"_67":17025,"_69":68},"KjDaJZo8",{},[17020],{"_35":206,"_2607":17021,"_2610":17022,"_41":17023,"_69":17024},[4715,14549],[4688,5332],{},"./document-entity","When you link to Document Entities, you may deep-link to a specific block (section) of the document heirarchy. These are identified by block ID, as defined by the Document Entity.",{"_31":17027,"_33":17050},[17028,17039],{"_31":17029,"_33":17030},[],{"_35":2509,"_37":17031,"_39":2287,"_41":17032,"_65":17033,"_67":17038,"_69":68},"ynaSMWyY",{},[17034],{"_35":2483,"_2607":17035,"_2610":17036,"_41":17037,"_69":68},[146],[4780],{},"hm://d/DOCUMENT_ID#BLOCK_REF - Block of Entity Ref",{"_31":17040,"_33":17041},[],{"_35":2509,"_37":17042,"_39":2287,"_41":17043,"_65":17044,"_67":17049,"_69":68},"W--n0qXt",{},[17045],{"_35":2483,"_2607":17046,"_2610":17047,"_41":17048,"_69":68},[146],[711],{},"hm://d/DOCUMENT_ID?v=VERSION_REF#BLOCK_REF - Block of Version Ref",{"_35":2509,"_37":17051,"_39":2287,"_41":17052,"_65":17053,"_67":17054,"_69":68},"L-Hogd4w",{"_2582":2583},[],"A block reference points to a specific block within a Entity Reference or a Version Reference.",{"_31":17056,"_33":17057},[],{"_35":2509,"_37":17058,"_39":2287,"_41":17059,"_65":17060,"_67":17065,"_69":68},"yUMyS3wX",{},[17061],{"_35":2483,"_2607":17062,"_2610":17063,"_41":17064,"_69":68},[1365],[4715],{},"A simple BLOCK_ID is a valid Block Ref, but it may also include a character range, pointing to a string within a block. This is a Block Range Ref:",{"_31":17067,"_33":17101},[17068,17079,17090],{"_31":17069,"_33":17070},[],{"_35":2509,"_37":17071,"_39":2287,"_41":17072,"_65":17073,"_67":17078,"_69":68},"L7fIJJqx",{},[17074],{"_35":2483,"_2607":17075,"_2610":17076,"_41":17077,"_69":68},[146],[985],{},"BLOCK_ID - the block ID of the ref",{"_31":17080,"_33":17081},[],{"_35":2509,"_37":17082,"_39":2287,"_41":17083,"_65":17084,"_67":17089,"_69":68},"jX8WE5Qr",{},[17085],{"_35":2483,"_2607":17086,"_2610":17087,"_41":17088,"_69":68},[146],[740],{},"START - utf8 character point (offset) of the start of the range ref",{"_31":17091,"_33":17092},[],{"_35":2509,"_37":17093,"_39":2287,"_41":17094,"_65":17095,"_67":17100,"_69":68},"SWXPhNzr",{},[17096],{"_35":2483,"_2607":17097,"_2610":17098,"_41":17099,"_69":68},[146],[172],{},"END - utf8 character point (offset) of the start of the range ref",{"_35":2483,"_37":17102,"_39":2287,"_41":17103,"_65":17104,"_67":17105,"_69":68},"XAjjwScg",{"_2582":2583,"_2486":68},[],"BLOCK_ID:START:END\n",{"_35":2580,"_37":17107,"_39":2287,"_41":17108,"_65":17109,"_67":17110,"_69":68},"U8BFqs-C",{"_2582":239},[],"Block References",{"_31":17112,"_33":17127},[17113],{"_31":17114,"_33":17122},[17115],{"_31":17116,"_33":17117},[],{"_35":2509,"_37":17118,"_39":2287,"_41":17119,"_65":17120,"_67":17121,"_69":68},"hSRCJniK",{},[],"TODO",{"_35":2509,"_37":17123,"_39":2287,"_41":17124,"_65":17125,"_67":17126,"_69":68},"kd760cyr",{"_2582":2583},[],"The following are real example links:",{"_35":2580,"_37":17128,"_39":2287,"_41":17129,"_65":17130,"_67":17131,"_69":68},"tZLl3lB5",{"_2582":239},[],"Example Links",{"_31":17133,"_33":17150},[17134],{"_31":17135,"_33":17136},[],{"_35":2509,"_37":17137,"_39":2287,"_41":17138,"_65":17139,"_67":17149,"_69":68},"MvR9FLK5",{},[17140,17145],{"_35":206,"_2607":17141,"_2610":17142,"_41":17143,"_69":17144},[682],[2612],{},"./hyperdocs-aer",{"_35":2483,"_2607":17146,"_2610":17147,"_41":17148,"_69":68},[5836],[2725],{},"Note: The Seed application uses the emerging \"Aer\" protocol to convert HTTPS URLs to hm:// links automatically under the hood",{"_35":2580,"_37":17151,"_39":2287,"_41":17152,"_65":17153,"_67":17154,"_69":68},"-kuoFahd",{"_2582":9788},[],"Web Links",[78],"/tech-talks/linking",{"_86":2302},{},{"_92":2287,"_96":2300},{"_37":2284,"_104":53,"_54":17161,"_70":2287,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,2286],1778632074377,[158,2284,2287,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/linking\",\"bafy2bzacedtevim3q4ybtoohumxjpvniscrxbpvd3hscofjobyls2c5djysug\",true]",{"_119":17166,"_156":17358,"_159":17359},{"_121":17167,"_141":44,"_142":17357,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":17168,"_37":17355},{"_28":17169,"_70":2308,"_71":53,"_72":17350,"_54":17351,"_80":2315,"_82":2315,"_84":17352,"_90":17353,"_92":2308,"_94":17354,"_98":99},[17170,17177,17184,17218,17257,17337],{"_31":17171,"_33":17172},[],{"_35":2509,"_37":17173,"_39":2308,"_41":17174,"_65":17175,"_67":17176,"_69":68},"oxYOjr7Z",{},[],"A block is a section of a document. Depending on the type of the block, it may have children.",{"_31":17178,"_33":17179},[],{"_35":2580,"_37":17180,"_39":2308,"_41":17181,"_65":17182,"_67":17183,"_69":68},"hjT7gE9n",{},[],"Text | Video | Image | File",{"_31":17185,"_33":17213},[17186,17193,17199,17206],{"_31":17187,"_33":17188},[],{"_35":2509,"_37":17189,"_39":2308,"_41":17190,"_65":17191,"_67":17192,"_69":68},"e7cmdgpN",{},[],"May have any children blocks",{"_31":17194,"_33":17195},[],{"_35":2580,"_37":17196,"_39":2308,"_41":17197,"_65":17198,"_67":239,"_69":68},"Jh9MJqVg",{},[],{"_31":17200,"_33":17201},[],{"_35":2580,"_37":17202,"_39":2308,"_41":17203,"_65":17204,"_67":17205,"_69":68},"tpltRJ9k",{},[],"OrderedList",{"_31":17207,"_33":17208},[],{"_35":2580,"_37":17209,"_39":2308,"_41":17210,"_65":17211,"_67":17212,"_69":68},"Sy7mStP6",{},[],"UnorderedList",{"_35":2580,"_37":17214,"_39":2308,"_41":17215,"_65":17216,"_67":17217,"_69":68},"jdRM2qW7",{},[],"GroupingContent",{"_31":17219,"_33":17252},[17220,17227,17234,17240,17246],{"_31":17221,"_33":17222},[],{"_35":2509,"_37":17223,"_39":2308,"_41":17224,"_65":17225,"_67":17226,"_69":68},"7rI1EAKq",{},[],"May have PhrasingContent blocks as children",{"_31":17228,"_33":17229},[],{"_35":2580,"_37":17230,"_39":2308,"_41":17231,"_65":17232,"_67":17233,"_69":68},"LmocCy5q",{},[],"Statement",{"_31":17235,"_33":17236},[],{"_35":2580,"_37":17237,"_39":2308,"_41":17238,"_65":17239,"_67":2580,"_69":68},"yhA1jTXO",{},[],{"_31":17241,"_33":17242},[],{"_35":2580,"_37":17243,"_39":2308,"_41":17244,"_65":17245,"_67":9788,"_69":68},"8WydP6Z9",{},[],{"_31":17247,"_33":17248},[],{"_35":2580,"_37":17249,"_39":2308,"_41":17250,"_65":17251,"_67":2483,"_69":68},"YNPFQdNq",{},[],{"_35":2580,"_37":17253,"_39":2308,"_41":17254,"_65":17255,"_67":17256,"_69":68},"Dgoo0x-q",{},[],"FlowContent",{"_31":17258,"_33":17332},[17259,17270,17284,17291,17297],{"_31":17260,"_33":17261},[],{"_35":2509,"_37":17262,"_39":2308,"_41":17263,"_65":17264,"_67":17269,"_69":68},"_rCUMR0j",{},[17265],{"_35":2483,"_2607":17266,"_2610":17267,"_41":17268,"_69":68},[146],[4855],{},"Link | Embed",{"_31":17271,"_33":17279},[17272],{"_31":17273,"_33":17274},[],{"_35":2483,"_37":17275,"_39":2308,"_41":17276,"_65":17277,"_67":17278,"_69":68},"_fIt_DRR",{"_2486":68},[],"export interface Text extends Literal {\n type: 'text'\n strong?: boolean\n emphasis?: boolean\n underline?: boolean\n strikethrough?: boolean\n superscript?: boolean\n subscript?: boolean\n code?: boolean\n color?: string\n // implementation relevant marks. not persistent\n codeToken?: string\n 'find-highlight'?: boolean\n conversations?: Array\n}\n\n",{"_35":2580,"_37":17280,"_39":2308,"_41":17281,"_65":17282,"_67":17283,"_69":68},"Fxo7_Agb",{},[],"Text",{"_31":17285,"_33":17286},[],{"_35":2580,"_37":17287,"_39":2308,"_41":17288,"_65":17289,"_67":17290,"_69":68},"Re0iz5X5",{},[],"Video",{"_31":17292,"_33":17293},[],{"_35":2580,"_37":17294,"_39":2308,"_41":17295,"_65":17296,"_67":2687,"_69":68},"rFYxOhuC",{},[],{"_31":17298,"_33":17327},[17299,17313],{"_31":17300,"_33":17308},[17301],{"_31":17302,"_33":17303},[],{"_35":2509,"_37":17304,"_39":2308,"_41":17305,"_65":17306,"_67":17307,"_69":68},"ALXTwVdg",{},[],"Note: why is \"file\" a Parent?",{"_35":2483,"_37":17309,"_39":2308,"_41":17310,"_65":17311,"_67":17312,"_69":68},"3NhlSr3k",{"_2582":9788,"_2486":68},[],"{\n type: 'file'\n name?: string\n title?: string\n defaultOpen\n children: [???]\n}\n",{"_31":17314,"_33":17322},[17315],{"_31":17316,"_33":17317},[],{"_35":2509,"_37":17318,"_39":2308,"_41":17319,"_65":17320,"_67":17321,"_69":68},"K9YUIBbL",{},[],"Note: what is defaultOpen",{"_35":2509,"_37":17323,"_39":2308,"_41":17324,"_65":17325,"_67":17326,"_69":68},"Cp6XLj7J",{"_2582":9788},[],"Note: what is the difference between title and name?",{"_35":2580,"_37":17328,"_39":2308,"_41":17329,"_65":17330,"_67":17331,"_69":68},"9emcDvnK",{},[],"File",{"_35":2580,"_37":17333,"_39":2308,"_41":17334,"_65":17335,"_67":17336,"_69":68},"B9qfc4L_",{},[],"PhrasingContent",{"_31":17338,"_33":17346},[17339],{"_31":17340,"_33":17341},[],{"_35":2509,"_37":17342,"_39":2308,"_41":17343,"_65":17344,"_67":17345,"_69":68},"2KlUj_R8",{},[],"mttast/types",{"_35":2580,"_37":17347,"_39":2308,"_41":17348,"_65":17349,"_67":12608,"_69":68},"AkHV_DFH",{"_2582":2583},[],[78],"/tech-talks/document-block-types",{"_86":2324},{},{"_92":2308,"_96":2322},{"_37":2305,"_104":53,"_54":17356,"_70":2308,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,2307],1778632074374,[158,2305,2308,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/document-block-types\",\"bafy2bzaceb424vzlgrj45dfv6kfsb4oaatln62bni2cirlgv5m2wpalye22m6\",true]",{"_119":17361,"_156":18092,"_159":18093},{"_121":17362,"_141":44,"_142":18091,"_144":-5,"_145":146,"_147":146,"_148":146,"_149":-5,"_150":-5,"_151":24,"_152":153,"_154":155},{"_35":26,"_26":17363,"_37":18089},{"_28":17364,"_70":2330,"_71":53,"_72":18084,"_54":18085,"_80":2337,"_82":2337,"_84":18086,"_90":18087,"_92":2330,"_94":18088,"_98":99},[17365,17376,17447,17482,17720,17780,17863,17912,18002,18060],{"_31":17366,"_33":17367},[],{"_35":2509,"_37":17368,"_39":2330,"_41":17369,"_65":17370,"_67":17375,"_69":68},"rL4w5r1V",{},[17371],{"_35":2483,"_2607":17372,"_2610":17373,"_41":17374,"_69":68},[1257],[4808],{},"The documentToText function converts hypermedia documents (with all their embeds) to plain text representation. It recursively resolves all inline and block embeds, replacing them with their actual content.",{"_31":17377,"_33":17443},[17378,17393,17404],{"_31":17379,"_33":17380},[],{"_35":2509,"_37":17381,"_39":2330,"_41":17382,"_65":17383,"_67":17392,"_69":68},"2yjKwR-z",{},[17384,17388],{"_35":2722,"_2607":17385,"_2610":17386,"_41":17387,"_69":68},[146],[985],{},{"_35":2483,"_2607":17389,"_2610":17390,"_41":17391,"_69":68},[1421],[5946],{},"Location: @shm/shared/document-to-text",{"_31":17394,"_33":17395},[],{"_35":2509,"_37":17396,"_39":2330,"_41":17397,"_65":17398,"_67":17403,"_69":68},"VS4fBMiZ",{},[17399],{"_35":2722,"_2607":17400,"_2610":17401,"_41":17402,"_69":68},[146],[1306],{},"Purpose: Generate plain text version of documents with resolved embeds",{"_31":17405,"_33":17434},[17406,17413,17420,17427],{"_31":17407,"_33":17408},[],{"_35":2509,"_37":17409,"_39":2330,"_41":17410,"_65":17411,"_67":17412,"_69":68},"2VpxijZR",{},[],"Text fragment rendering with inline embeds resolved",{"_31":17414,"_33":17415},[],{"_35":2509,"_37":17416,"_39":2330,"_41":17417,"_65":17418,"_67":17419,"_69":68},"aWfpFy5M",{},[],"Document search indexing",{"_31":17421,"_33":17422},[],{"_35":2509,"_37":17423,"_39":2330,"_41":17424,"_65":17425,"_67":17426,"_69":68},"1i9ySoY3",{},[],"Export to plain text",{"_31":17428,"_33":17429},[],{"_35":2509,"_37":17430,"_39":2330,"_41":17431,"_65":17432,"_67":17433,"_69":68},"EjfTA5zS",{},[],"Content preview generation",{"_35":2509,"_37":17435,"_39":2330,"_41":17436,"_65":17437,"_67":17442,"_69":68},"1a8Rwxh_",{"_2582":2583},[17438],{"_35":2722,"_2607":17439,"_2610":17440,"_41":17441,"_69":68},[146],[1365],{},"Use Cases:",{"_35":2580,"_37":17444,"_39":2330,"_41":17445,"_65":17446,"_67":15903,"_69":68},"F0NAJYwm",{"_2582":2583},[],{"_31":17448,"_33":17477},[17449,17463],{"_31":17450,"_33":17458},[17451],{"_31":17452,"_33":17453},[],{"_35":2483,"_37":17454,"_39":2330,"_41":17455,"_65":17456,"_67":17457,"_69":68},"RFKRK2P0",{"_2486":11038},[],"async function documentToText({\n documentId,\n grpcClient,\n options = {},\n}: {\n documentId: UnpackedHypermediaId\n grpcClient: GRPCClient\n options: DocumentToTextOptions\n}): Promise\n",{"_35":2580,"_37":17459,"_39":2330,"_41":17460,"_65":17461,"_67":17462,"_69":68},"4Klrb3gU",{"_2582":239},[],"Function Signature",{"_31":17464,"_33":17472},[17465],{"_31":17466,"_33":17467},[],{"_35":2483,"_37":17468,"_39":2330,"_41":17469,"_65":17470,"_67":17471,"_69":68},"_lOG_V_e",{"_2486":11038},[],"interface DocumentToTextOptions {\n maxDepth?: number // Maximum embed depth (default: 10)\n resolveInlineEmbeds?: boolean // Replace inline embeds with doc names (default: true)\n lineBreaks?: boolean // Add line breaks between blocks (default: true)\n}\n",{"_35":2580,"_37":17473,"_39":2330,"_41":17474,"_65":17475,"_67":17476,"_69":68},"A6tUW4tq",{"_2582":239},[],"Options",{"_35":2580,"_37":17478,"_39":2330,"_41":17479,"_65":17480,"_67":17481,"_69":68},"eAdkQ8er",{"_2582":239},[],"API",{"_31":17483,"_33":17715},[17484,17544,17597,17632,17675],{"_31":17485,"_33":17539},[17486],{"_31":17487,"_33":17534},[17488,17495,17502,17509,17520,17527],{"_31":17489,"_33":17490},[],{"_35":2509,"_37":17491,"_39":2330,"_41":17492,"_65":17493,"_67":17494,"_69":68},"ox4K0gvL",{},[],"Paragraphs: Extract text content",{"_31":17496,"_33":17497},[],{"_35":2509,"_37":17498,"_39":2330,"_41":17499,"_65":17500,"_67":17501,"_69":68},"Rk1U2yft",{},[],"Headings: Extract heading text",{"_31":17503,"_33":17504},[],{"_35":2509,"_37":17505,"_39":2330,"_41":17506,"_65":17507,"_67":17508,"_69":68},"hADtk2H6",{},[],"Code blocks: Include code content",{"_31":17510,"_33":17511},[],{"_35":2509,"_37":17512,"_39":2330,"_41":17513,"_65":17514,"_67":17519,"_69":68},"KggYz0tx",{},[17515],{"_35":2483,"_2607":17516,"_2610":17517,"_41":17518,"_69":68},[2883],[4781],{},"Buttons: Extract button labels from attributes.name",{"_31":17521,"_33":17522},[],{"_35":2509,"_37":17523,"_39":2330,"_41":17524,"_65":17525,"_67":17526,"_69":68},"BL6Kz9s3",{},[],"Images/Videos/Files: Include captions",{"_31":17528,"_33":17529},[],{"_35":2509,"_37":17530,"_39":2330,"_41":17531,"_65":17532,"_67":17533,"_69":68},"shYGI7F8",{},[],"Embeds: Recursively fetch and include content",{"_35":2509,"_37":17535,"_39":2330,"_41":17536,"_65":17537,"_67":17538,"_69":68},"8jcOKDJF",{"_2582":2583},[],"Processes document blocks depth-first:",{"_35":2580,"_37":17540,"_39":2330,"_41":17541,"_65":17542,"_67":17543,"_69":68},"sJ16mThx",{"_2582":239},[],"1. Hierarchical Block Processing",{"_31":17545,"_33":17592},[17546,17578,17585],{"_31":17547,"_33":17573},[17548,17555,17562],{"_31":17549,"_33":17550},[],{"_35":2509,"_37":17551,"_39":2330,"_41":17552,"_65":17553,"_67":17554,"_69":68},"sbCX8Z6V",{},[],"Detects inline embed annotations",{"_31":17556,"_33":17557},[],{"_35":2509,"_37":17558,"_39":2330,"_41":17559,"_65":17560,"_67":17561,"_69":68},"QMTvZKWc",{},[],"Fetches referenced document",{"_31":17563,"_33":17564},[],{"_35":2509,"_37":17565,"_39":2330,"_41":17566,"_65":17567,"_67":17572,"_69":68},"w4GrklP3",{},[17568],{"_35":2483,"_2607":17569,"_2610":17570,"_41":17571,"_69":68},[4797],[4688],{},"Replaces marker with @DocumentName",{"_35":2509,"_37":17574,"_39":2330,"_41":17575,"_65":17576,"_67":17577,"_69":68},"bgichije",{"_2582":2583},[],"Replaces invisible character markers (U+FEFF) with document names:",{"_31":17579,"_33":17580},[],{"_35":2509,"_37":17581,"_39":2330,"_41":17582,"_65":17583,"_67":17584,"_69":68},"iduMVkW9",{},[],"Example:",{"_31":17586,"_33":17587},[],{"_35":2483,"_37":17588,"_39":2330,"_41":17589,"_65":17590,"_67":17591,"_69":68},"b6Ew4AIg",{"_2486":68},[],"\"Check out this post!\" → \"Check out @Alice's Guide this post!\"\n",{"_35":2580,"_37":17593,"_39":2330,"_41":17594,"_65":17595,"_67":17596,"_69":68},"qMh9mU7D",{"_2582":239},[],"2. Inline Embed Resolution",{"_31":17598,"_33":17627},[17599],{"_31":17600,"_33":17622},[17601,17608,17615],{"_31":17602,"_33":17603},[],{"_35":2509,"_37":17604,"_39":2330,"_41":17605,"_65":17606,"_67":17607,"_69":68},"3S4TJjdH",{},[],"Full document embeds",{"_31":17609,"_33":17610},[],{"_35":2509,"_37":17611,"_39":2330,"_41":17612,"_65":17613,"_67":17614,"_69":68},"3hcT50OB",{},[],"Block-specific embeds (blockRef)",{"_31":17616,"_33":17617},[],{"_35":2509,"_37":17618,"_39":2330,"_41":17619,"_65":17620,"_67":17621,"_69":68},"o1xK42ED",{},[],"Block range embeds (blockRef with range)",{"_35":2509,"_37":17623,"_39":2330,"_41":17624,"_65":17625,"_67":17626,"_69":68},"3RmJFSix",{"_2582":2583},[],"Recursively fetches and includes embedded documents:",{"_35":2580,"_37":17628,"_39":2330,"_41":17629,"_65":17630,"_67":17631,"_69":68},"6yQVyD99",{"_2582":239},[],"3. Block Embed Resolution",{"_31":17633,"_33":17670},[17634],{"_31":17635,"_33":17665},[17636,17647,17658],{"_31":17637,"_33":17638},[],{"_35":2509,"_37":17639,"_39":2330,"_41":17640,"_65":17641,"_67":17646,"_69":68},"eCYZCv5a",{},[17642],{"_35":2483,"_2607":17643,"_2610":17644,"_41":17645,"_69":68},[146],[985],{},"#blockId - Returns only that block's content",{"_31":17648,"_33":17649},[],{"_35":2509,"_37":17650,"_39":2330,"_41":17651,"_65":17652,"_67":17657,"_69":68},"6lTTlb8G",{},[17653],{"_35":2483,"_2607":17654,"_2610":17655,"_41":17656,"_69":68},[146],[309],{},"#blockId[start:end] - Returns only children within range",{"_31":17659,"_33":17660},[],{"_35":2509,"_37":17661,"_39":2330,"_41":17662,"_65":17663,"_67":17664,"_69":68},"EulEJMTK",{},[],"Respects parent-child relationships",{"_35":2509,"_37":17666,"_39":2330,"_41":17667,"_65":17668,"_67":17669,"_69":68},"Lo2Hm2zC",{"_2582":2583},[],"Handles blockRef and blockRange:",{"_35":2580,"_37":17671,"_39":2330,"_41":17672,"_65":17673,"_67":17674,"_69":68},"DqSFBeU_",{"_2582":239},[],"4. Fragment Support",{"_31":17676,"_33":17710},[17677,17688,17699],{"_31":17678,"_33":17679},[],{"_35":2509,"_37":17680,"_39":2330,"_41":17681,"_65":17682,"_67":17687,"_69":68},"J8-FgKry",{},[17683],{"_35":2722,"_2607":17684,"_2610":17685,"_41":17686,"_69":68},[146],[4780],{},"Circular reference detection: Tracks visited documents",{"_31":17689,"_33":17690},[],{"_35":2509,"_37":17691,"_39":2330,"_41":17692,"_65":17693,"_67":17698,"_69":68},"Ap1tWLza",{},[17694],{"_35":2722,"_2607":17695,"_2610":17696,"_41":17697,"_69":68},[146],[840],{},"Depth limiting: Prevents infinite recursion",{"_31":17700,"_33":17701},[],{"_35":2509,"_37":17702,"_39":2330,"_41":17703,"_65":17704,"_67":17709,"_69":68},"5VebPdSp",{},[17705],{"_35":2722,"_2607":17706,"_2610":17707,"_41":17708,"_69":68},[146],[840],{},"Error handling: Graceful fallbacks for missing content",{"_35":2580,"_37":17711,"_39":2330,"_41":17712,"_65":17713,"_67":17714,"_69":68},"PYNpKC7j",{"_2582":2583},[],"5. Safety Features",{"_35":2580,"_37":17716,"_39":2330,"_41":17717,"_65":17718,"_67":17719,"_69":68},"uKSH3x81",{"_2582":239},[],"Features",{"_31":17721,"_33":17775},[17722,17729,17750],{"_31":17723,"_33":17724},[],{"_35":2509,"_37":17725,"_39":2330,"_41":17726,"_65":17727,"_67":17728,"_69":68},"QsC4xPWo",{},[],"The function is available in both desktop and web apps through the document content context:",{"_31":17730,"_33":17745},[17731,17738],{"_31":17732,"_33":17733},[],{"_35":2509,"_37":17734,"_39":2330,"_41":17735,"_65":17736,"_67":17737,"_69":68},"ehSJmWjF",{},[],"Direct access to grpcClient:",{"_31":17739,"_33":17740},[],{"_35":2483,"_37":17741,"_39":2330,"_41":17742,"_65":17743,"_67":17744,"_69":68},"S4GEFRmw",{"_2486":11038},[],"const {getDocumentText} = useDocContentContext()\n\nconst text = await getDocumentText(documentId, {\n lineBreaks: false,\n resolveInlineEmbeds: true,\n})\n",{"_35":2580,"_37":17746,"_39":2330,"_41":17747,"_65":17748,"_67":17749,"_69":68},"TxoCMZR7",{"_2582":239},[],"Desktop App",{"_31":17751,"_33":17770},[17752,17763],{"_31":17753,"_33":17754},[],{"_35":2509,"_37":17755,"_39":2330,"_41":17756,"_65":17757,"_67":17762,"_69":68},"_F1Xxxx-",{},[17758],{"_35":2483,"_2607":17759,"_2610":17760,"_41":17761,"_69":68},[1111],[4337],{},"API endpoint at /hm/api/document-text:",{"_31":17764,"_33":17765},[],{"_35":2483,"_37":17766,"_39":2330,"_41":17767,"_65":17768,"_67":17769,"_69":68},"vxMubJEa",{"_2486":11038},[],"const {getDocumentText} = useDocContentContext()\n\n// Same API, but fetches from server\nconst text = await getDocumentText(documentId, {\n maxDepth: 5,\n resolveInlineEmbeds: true,\n})\n",{"_35":2580,"_37":17771,"_39":2330,"_41":17772,"_65":17773,"_67":17774,"_69":68},"kOhWn-i9",{"_2582":239},[],"Web App",{"_35":2580,"_37":17776,"_39":2330,"_41":17777,"_65":17778,"_67":17779,"_69":68},"L7ETUl2-",{"_2582":239},[],"Cross-Platform Integration",{"_31":17781,"_33":17858},[17782,17796],{"_31":17783,"_33":17791},[17784],{"_31":17785,"_33":17786},[],{"_35":2483,"_37":17787,"_39":2330,"_41":17788,"_65":17789,"_67":17790,"_69":68},"0rbj3DcF",{"_2486":68},[],"Desktop:\n Component → useDocContentContext() → documentToText(grpcClient) → Text\n\nWeb:\n Component → useDocContentContext() → API /hm/api/document-text → documentToText(grpcClient) → Text\n",{"_35":2580,"_37":17792,"_39":2330,"_41":17793,"_65":17794,"_67":17795,"_69":68},"SWuYmaiu",{"_2582":239},[],"Architecture",{"_31":17797,"_33":17853},[17798,17809,17820,17831,17842],{"_31":17799,"_33":17800},[],{"_35":2509,"_37":17801,"_39":2330,"_41":17802,"_65":17803,"_67":17808,"_69":68},"wI-wCXnr",{},[17804],{"_35":2483,"_2607":17805,"_2610":17806,"_41":17807,"_69":68},[146],[6141],{},"frontend/packages/shared/src/document-to-text.ts - Core implementation",{"_31":17810,"_33":17811},[],{"_35":2509,"_37":17812,"_39":2330,"_41":17813,"_65":17814,"_67":17819,"_69":68},"-pBL1mqg",{},[17815],{"_35":2483,"_2607":17816,"_2610":17817,"_41":17818,"_69":68},[146],[4712],{},"frontend/packages/shared/src/document-content-types.ts - Context interface",{"_31":17821,"_33":17822},[],{"_35":2509,"_37":17823,"_39":2330,"_41":17824,"_65":17825,"_67":17830,"_69":68},"_6ZxJjid",{},[17826],{"_35":2483,"_2607":17827,"_2610":17828,"_41":17829,"_69":68},[146],[5835],{},"frontend/apps/desktop/src/pages/document-content-provider.tsx - Desktop provider",{"_31":17832,"_33":17833},[],{"_35":2509,"_37":17834,"_39":2330,"_41":17835,"_65":17836,"_67":17841,"_69":68},"cgHf7iBb",{},[17837],{"_35":2483,"_2607":17838,"_2610":17839,"_41":17840,"_69":68},[146],[4716],{},"frontend/apps/web/app/doc-content-provider.tsx - Web provider",{"_31":17843,"_33":17844},[],{"_35":2509,"_37":17845,"_39":2330,"_41":17846,"_65":17847,"_67":17852,"_69":68},"wd0CkdCC",{},[17848],{"_35":2483,"_2607":17849,"_2610":17850,"_41":17851,"_69":68},[146],[5962],{},"frontend/apps/web/app/routes/hm.api.document-text.tsx - Web API endpoint",{"_35":2580,"_37":17854,"_39":2330,"_41":17855,"_65":17856,"_67":17857,"_69":68},"aKj4ju1t",{"_2582":2583},[],"Key Files",{"_35":2580,"_37":17859,"_39":2330,"_41":17860,"_65":17861,"_67":17862,"_69":68},"R_CnHL6x",{"_2582":239},[],"Implementation Details",{"_31":17864,"_33":17907},[17865,17879,17893],{"_31":17866,"_33":17874},[17867],{"_31":17868,"_33":17869},[],{"_35":2483,"_37":17870,"_39":2330,"_41":17871,"_65":17872,"_67":17873,"_69":68},"oMalA2nj",{"_2486":11038},[],"import {documentToText, hmId} from '@shm/shared'\nimport {grpcClient} from './grpc-client'\n\nconst documentId = hmId('account123', {path: ['my-doc']})\nconst text = await documentToText({\n documentId,\n grpcClient,\n options: {},\n})\nconsole.log(text)\n",{"_35":2580,"_37":17875,"_39":2330,"_41":17876,"_65":17877,"_67":17878,"_69":68},"JDfdul2h",{"_2582":239},[],"Basic Usage",{"_31":17880,"_33":17888},[17881],{"_31":17882,"_33":17883},[],{"_35":2483,"_37":17884,"_39":2330,"_41":17885,"_65":17886,"_67":17887,"_69":68},"fnzf6VPT",{"_2486":11038},[],"// Compact text without line breaks\nconst compactText = await documentToText({\n documentId,\n grpcClient,\n options: {\n lineBreaks: false,\n maxDepth: 5,\n resolveInlineEmbeds: true,\n },\n})\n\n// Without inline embed resolution (keep original text)\nconst rawText = await documentToText({\n documentId,\n grpcClient,\n options: {\n resolveInlineEmbeds: false,\n },\n})\n",{"_35":2580,"_37":17889,"_39":2330,"_41":17890,"_65":17891,"_67":17892,"_69":68},"V3TZ73lm",{"_2582":239},[],"With Options",{"_31":17894,"_33":17902},[17895],{"_31":17896,"_33":17897},[],{"_35":2483,"_37":17898,"_39":2330,"_41":17899,"_65":17900,"_67":17901,"_69":68},"6uWCLbY4",{"_2486":11038},[],"function MyComponent({docId}: {docId: UnpackedHypermediaId}) {\n const {getDocumentText} = useDocContentContext()\n const [text, setText] = useState('')\n\n useEffect(() => {\n getDocumentText?.(docId, {lineBreaks: false})\n .then(setText)\n .catch(console.error)\n }, [docId, getDocumentText])\n\n return {text} \n}\n",{"_35":2580,"_37":17903,"_39":2330,"_41":17904,"_65":17905,"_67":17906,"_69":68},"kGrqbGK8",{"_2582":239},[],"In React Components",{"_35":2580,"_37":17908,"_39":2330,"_41":17909,"_65":17910,"_67":17911,"_69":68},"zt6huspZ",{"_2582":239},[],"Usage Examples",{"_31":17913,"_33":17998},[17914,17984,17991],{"_31":17915,"_33":17979},[17916,17923,17930,17937,17944,17951,17958,17965,17972],{"_31":17917,"_33":17918},[],{"_35":2509,"_37":17919,"_39":2330,"_41":17920,"_65":17921,"_67":17922,"_69":68},"Qu33ZZxI",{},[],"Basic text extraction",{"_31":17924,"_33":17925},[],{"_35":2509,"_37":17926,"_39":2330,"_41":17927,"_65":17928,"_67":17929,"_69":68},"Sor5obQF",{},[],"Inline embed resolution",{"_31":17931,"_33":17932},[],{"_35":2509,"_37":17933,"_39":2330,"_41":17934,"_65":17935,"_67":17936,"_69":68},"AHtRxHrt",{},[],"Block embed processing",{"_31":17938,"_33":17939},[],{"_35":2509,"_37":17940,"_39":2330,"_41":17941,"_65":17942,"_67":17943,"_69":68},"Ozha4mZZ",{},[],"Nested structures",{"_31":17945,"_33":17946},[],{"_35":2509,"_37":17947,"_39":2330,"_41":17948,"_65":17949,"_67":17950,"_69":68},"FIvq_W4U",{},[],"Circular reference detection",{"_31":17952,"_33":17953},[],{"_35":2509,"_37":17954,"_39":2330,"_41":17955,"_65":17956,"_67":17957,"_69":68},"qBCOdnsa",{},[],"Max depth handling",{"_31":17959,"_33":17960},[],{"_35":2509,"_37":17961,"_39":2330,"_41":17962,"_65":17963,"_67":17964,"_69":68},"glQ2zRwI",{},[],"BlockRef/BlockRange fragments",{"_31":17966,"_33":17967},[],{"_35":2509,"_37":17968,"_39":2330,"_41":17969,"_65":17970,"_67":17971,"_69":68},"ef2RkrfF",{},[],"Button and heading extraction",{"_31":17973,"_33":17974},[],{"_35":2509,"_37":17975,"_39":2330,"_41":17976,"_65":17977,"_67":17978,"_69":68},"RQDs77oK",{},[],"LineBreaks option",{"_35":2509,"_37":17980,"_39":2330,"_41":17981,"_65":17982,"_67":17983,"_69":68},"FLgcLBRl",{"_2582":2583},[],"17 comprehensive tests covering:",{"_31":17985,"_33":17986},[],{"_35":2509,"_37":17987,"_39":2330,"_41":17988,"_65":17989,"_67":17990,"_69":68},"qxBaH-Tu",{},[],"Run tests:",{"_31":17992,"_33":17993},[],{"_35":2483,"_37":17994,"_39":2330,"_41":17995,"_65":17996,"_67":17997,"_69":68},"MfvNOt1b",{"_2486":7664},[],"NODE_ENV=test yarn workspace @shm/shared test run document-to-text\n",{"_35":2580,"_37":17999,"_39":2330,"_41":18000,"_65":18001,"_67":12234,"_69":68},"X8Uf4__I",{"_2582":239},[],{"_31":18003,"_33":18056},[18004,18015,18030,18045],{"_31":18005,"_33":18006},[],{"_35":2509,"_37":18007,"_39":2330,"_41":18008,"_65":18009,"_67":18014,"_69":68},"NgQXvzk7",{},[18010],{"_35":2722,"_2607":18011,"_2610":18012,"_41":18013,"_69":68},[146],[1306],{},"Caching: Consider caching results for frequently accessed documents",{"_31":18016,"_33":18017},[],{"_35":2509,"_37":18018,"_39":2330,"_41":18019,"_65":18020,"_67":18029,"_69":68},"7HYuySWW",{},[18021,18025],{"_35":2722,"_2607":18022,"_2610":18023,"_41":18024,"_69":68},[146],[840],{},{"_35":2483,"_2607":18026,"_2610":18027,"_41":18028,"_69":68},[2357],[4780],{},"Depth limiting: Use maxDepth option for large document trees",{"_31":18031,"_33":18032},[],{"_35":2509,"_37":18033,"_39":2330,"_41":18034,"_65":18035,"_67":18044,"_69":68},"JG_RnhdZ",{},[18036,18040],{"_35":2722,"_2607":18037,"_2610":18038,"_41":18039,"_69":68},[146],[4700],{},{"_35":2483,"_2607":18041,"_2610":18042,"_41":18043,"_69":68},[3566],[485],{},"Inline embeds: Disabling resolveInlineEmbeds improves performance",{"_31":18046,"_33":18047},[],{"_35":2509,"_37":18048,"_39":2330,"_41":18049,"_65":18050,"_67":18055,"_69":68},"G8aL95t-",{},[18051],{"_35":2722,"_2607":18052,"_2610":18053,"_41":18054,"_69":68},[146],[740],{},"Async: Function is async and may take time for deep embed trees",{"_35":2580,"_37":18057,"_39":2330,"_41":18058,"_65":18059,"_67":16672,"_69":68},"oy86ioXd",{"_2582":2583},[],{"_31":18061,"_33":18080},[18062,18068,18074],{"_31":18063,"_33":18064},[],{"_35":2509,"_37":18065,"_39":2330,"_41":18066,"_65":18067,"_67":2281,"_69":68},"6CMsQMZA",{},[],{"_31":18069,"_33":18070},[],{"_35":2509,"_37":18071,"_39":2330,"_41":18072,"_65":18073,"_67":16839,"_69":68},"KGUb_cb3",{},[],{"_31":18075,"_33":18076},[],{"_35":2509,"_37":18077,"_39":2330,"_41":18078,"_65":18079,"_67":16827,"_69":68},"h_fNcIwy",{},[],{"_35":2580,"_37":18081,"_39":2330,"_41":18082,"_65":18083,"_67":16844,"_69":68},"je8VphVk",{"_2582":2583},[],[78],"/tech-talks/document-to-text-function",{"_86":2346},{},{"_92":2330,"_96":2344},{"_37":2327,"_104":53,"_54":18090,"_70":2330,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_103":6},[55,2329],1778632074369,[158,2327,2330,6],"[\"ENTITY\",\"hm://z6MkuBbsB1HbSNXLvJCRCrPhimY6g7tzhr4qvcYKPuSZzhno/tech-talks/document-to-text-function\",\"bafy2bzacecdcvfpp3eagebhnu4eolfvyon2pfvp2ykl4qnidggatkabnsumem\",true]","ssrContentHTML","","enableWebSigning","origin","homeMetadata",{"_86":190,"_191":111,"_192":193,"_194":195,"_196":24,"_197":198},"originHomeId",{"_104":53,"_37":244,"_54":18102,"_70":-5,"_106":-5,"_107":-5,"_108":-5,"_109":-5},[],"meta",{"_18105":18106,"_19352":19353},"values",{"_18107":18108,"_18110":18111,"_18112":18113,"_18114":18115,"_18117":18118,"_18119":18120,"_18121":18122,"_18124":18125,"_18126":18127,"_18128":18129,"_18130":18131,"_18132":18133,"_18134":18135,"_18136":18137,"_18138":18139,"_18140":18141,"_18142":18143,"_18144":18145,"_18146":18147,"_18148":18149,"_18150":18151,"_18152":18153,"_18154":18155,"_18156":18157,"_18158":18159,"_18160":18161,"_18162":18163,"_18164":18165,"_18166":18167,"_18168":18169,"_18170":18171,"_18172":18173,"_18174":18175,"_18176":18177,"_18178":18179,"_18180":18181,"_18182":18183,"_18184":18185,"_18186":18187,"_18188":18189,"_18190":18191,"_18192":18193,"_18194":18195,"_18196":18197,"_18198":18199,"_18200":18201,"_18202":18203,"_18204":18205,"_18206":18207,"_18208":18209,"_18210":18211,"_18212":18213,"_18214":18215,"_18216":18217,"_18218":18219,"_18220":18221,"_18222":18223,"_18224":18225,"_18226":18227,"_18228":18229,"_18230":18231,"_18232":18233,"_18234":18235,"_18236":18237,"_18238":18239,"_18240":18241,"_18242":18243,"_18244":18245,"_18246":18247,"_18248":18249,"_18250":18251,"_18252":18253,"_18254":18255,"_18256":18257,"_18258":18259,"_18260":18261,"_18262":18263,"_18264":18265,"_18266":18267,"_18268":18269,"_18270":18271,"_18272":18273,"_18274":18275,"_18276":18277,"_18278":18279,"_18280":18281,"_18282":18283,"_18284":18285,"_18286":18287,"_18288":18289,"_18290":18291,"_18292":18293,"_18294":18295,"_18296":18297,"_18298":18299,"_18300":18301,"_18302":18303,"_18304":18305,"_18306":18307,"_18308":18309,"_18310":18311,"_18312":18313,"_18314":18315,"_18316":18317,"_18318":18319,"_18320":18321,"_18322":18323,"_18324":18325,"_18326":18327,"_18328":18329,"_18330":18331,"_18332":18333,"_18334":18335,"_18336":18337,"_18338":18339,"_18340":18341,"_18342":18343,"_18344":18345,"_18346":18347,"_18348":18349,"_18350":18351,"_18352":18353,"_18354":18355,"_18356":18357,"_18358":18359,"_18360":18361,"_18362":18363,"_18364":18365,"_18366":18367,"_18368":18369,"_18370":18371,"_18372":18373,"_18374":18375,"_18376":18377,"_18378":18379,"_18380":18381,"_18382":18383,"_18384":18385,"_18386":18387,"_18388":18389,"_18390":18391,"_18392":18393,"_18394":18395,"_18396":18397,"_18398":18399,"_18400":18401,"_18402":18403,"_18404":18405,"_18406":18407,"_18408":18409,"_18410":18411,"_18412":18413,"_18414":18415,"_18416":18417,"_18418":18419,"_18420":18421,"_18422":18423,"_18424":18425,"_18426":18427,"_18428":18429,"_18430":18431,"_18432":18433,"_18434":18435,"_18436":18437,"_18438":18439,"_18440":18441,"_18442":18443,"_18444":18445,"_18446":18447,"_18448":18449,"_18450":18451,"_18452":18453,"_18454":18455,"_18456":18457,"_18458":18459,"_18460":18461,"_18462":18463,"_18464":18465,"_18466":18467,"_18468":18469,"_18470":18471,"_18472":18473,"_18474":18475,"_18476":18477,"_18478":18479,"_18480":18481,"_18482":18483,"_18484":18485,"_18486":18487,"_18488":18489,"_18490":18491,"_18492":18493,"_18494":18495,"_18496":18497,"_18498":18499,"_18500":18501,"_18502":18503,"_18504":18505,"_18506":18507,"_18508":18509,"_18510":18511,"_18512":18513,"_18514":18515,"_18516":18517,"_18518":18519,"_18520":18521,"_18522":18523,"_18524":18525,"_18526":18527,"_18528":18529,"_18530":18531,"_18532":18533,"_18534":18535,"_18536":18537,"_18538":18539,"_18540":18541,"_18542":18543,"_18544":18545,"_18546":18547,"_18548":18549,"_18550":18551,"_18552":18553,"_18554":18555,"_18556":18557,"_18558":18559,"_18560":18561,"_18562":18563,"_18564":18565,"_18566":18567,"_18568":18569,"_18570":18571,"_18572":18573,"_18574":18575,"_18576":18577,"_18578":18579,"_18580":18581,"_18582":18583,"_18584":18585,"_18586":18587,"_18588":18589,"_18590":18591,"_18592":18593,"_18594":18595,"_18596":18597,"_18598":18599,"_18600":18601,"_18602":18603,"_18604":18605,"_18606":18607,"_18608":18609,"_18610":18611,"_18612":18613,"_18614":18615,"_18616":18617,"_18618":18619,"_18620":18621,"_18622":18623,"_18624":18625,"_18626":18627,"_18628":18629,"_18630":18631,"_18632":18633,"_18634":18635,"_18636":18637,"_18638":18639,"_18640":18641,"_18642":18643,"_18644":18645,"_18646":18647,"_18648":18649,"_18650":18651,"_18652":18653,"_18654":18655,"_18656":18657,"_18658":18659,"_18660":18661,"_18662":18663,"_18664":18665,"_18666":18667,"_18668":18669,"_18670":18671,"_18672":18673,"_18674":18675,"_18676":18677,"_18678":18679,"_18680":18681,"_18682":18683,"_18684":18685,"_18686":18687,"_18688":18689,"_18690":18691,"_18692":18693,"_18694":18695,"_18696":18697,"_18698":18699,"_18700":18701,"_18702":18703,"_18704":18705,"_18706":18707,"_18708":18709,"_18710":18711,"_18712":18713,"_18714":18715,"_18716":18717,"_18718":18719,"_18720":18721,"_18722":18723,"_18724":18725,"_18726":18727,"_18728":18729,"_18730":18731,"_18732":18733,"_18734":18735,"_18736":18737,"_18738":18739,"_18740":18741,"_18742":18743,"_18744":18745,"_18746":18747,"_18748":18749,"_18750":18751,"_18752":18753,"_18754":18755,"_18756":18757,"_18758":18759,"_18760":18761,"_18762":18763,"_18764":18765,"_18766":18767,"_18768":18769,"_18770":18771,"_18772":18773,"_18774":18775,"_18776":18777,"_18778":18779,"_18780":18781,"_18782":18783,"_18784":18785,"_18786":18787,"_18788":18789,"_18790":18791,"_18792":18793,"_18794":18795,"_18796":18797,"_18798":18799,"_18800":18801,"_18802":18803,"_18804":18805,"_18806":18807,"_18808":18809,"_18810":18811,"_18812":18813,"_18814":18815,"_18816":18817,"_18818":18819,"_18820":18821,"_18822":18823,"_18824":18825,"_18826":18827,"_18828":18829,"_18830":18831,"_18832":18833,"_18834":18835,"_18836":18837,"_18838":18839,"_18840":18841,"_18842":18843,"_18844":18845,"_18846":18847,"_18848":18849,"_18850":18851,"_18852":18853,"_18854":18855,"_18856":18857,"_18858":18859,"_18860":18861,"_18862":18863,"_18864":18865,"_18866":18867,"_18868":18869,"_18870":18871,"_18872":18873,"_18874":18875,"_18876":18877,"_18878":18879,"_18880":18881,"_18882":18883,"_18884":18885,"_18886":18887,"_18888":18889,"_18890":18891,"_18892":18893,"_18894":18895,"_18896":18897,"_18898":18899,"_18900":18901,"_18902":18903,"_18904":18905,"_18906":18907,"_18908":18909,"_18910":18911,"_18912":18913,"_18914":18915,"_18916":18917,"_18918":18919,"_18920":18921,"_18922":18923,"_18924":18925,"_18926":18927,"_18928":18929,"_18930":18931,"_18932":18933,"_18934":18935,"_18936":18937,"_18938":18939,"_18940":18941,"_18942":18943,"_18944":18945,"_18946":18947,"_18948":18949,"_18950":18951,"_18952":18953,"_18954":18955,"_18956":18957,"_18958":18959,"_18960":18961,"_18962":18963,"_18964":18965,"_18966":18967,"_18968":18969,"_18970":18971,"_18972":18973,"_18974":18975,"_18976":18977,"_18978":18979,"_18980":18981,"_18982":18983,"_18984":18985,"_18986":18987,"_18988":18989,"_18990":18991,"_18992":18993,"_18994":18995,"_18996":18997,"_18998":18999,"_19000":19001,"_19002":19003,"_19004":19005,"_19006":19007,"_19008":19009,"_19010":19011,"_19012":19013,"_19014":19015,"_19016":19017,"_19018":19019,"_19020":19021,"_19022":19023,"_19024":19025,"_19026":19027,"_19028":19029,"_19030":19031,"_19032":19033,"_19034":19035,"_19036":19037,"_19038":19039,"_19040":19041,"_19042":19043,"_19044":19045,"_19046":19047,"_19048":19049,"_19050":19051,"_19052":19053,"_19054":19055,"_19056":19057,"_19058":19059,"_19060":19061,"_19062":19063,"_19064":19065,"_19066":19067,"_19068":19069,"_19070":19071,"_19072":19073,"_19074":19075,"_19076":19077,"_19078":19079,"_19080":19081,"_19082":19083,"_19084":19085,"_19086":19087,"_19088":19089,"_19090":19091,"_19092":19093,"_19094":19095,"_19096":19097,"_19098":19099,"_19100":19101,"_19102":19103,"_19104":19105,"_19106":19107,"_19108":19109,"_19110":19111,"_19112":19113,"_19114":19115,"_19116":19117,"_19118":19119,"_19120":19121,"_19122":19123,"_19124":19125,"_19126":19127,"_19128":19129,"_19130":19131,"_19132":19133,"_19134":19135,"_19136":19137,"_19138":19139,"_19140":19141,"_19142":19143,"_19144":19145,"_19146":19147,"_19148":19149,"_19150":19151,"_19152":19153,"_19154":19155,"_19156":19157,"_19158":19159,"_19160":19161,"_19162":19163,"_19164":19165,"_19166":19167,"_19168":19169,"_19170":19171,"_19172":19173,"_19174":19175,"_19176":19177,"_19178":19179,"_19180":19181,"_19182":19183,"_19184":19185,"_19186":19187,"_19188":19189,"_19190":19191,"_19192":19193,"_19194":19195,"_19196":19197,"_19198":19199,"_19200":19201,"_19202":19203,"_19204":19205,"_19206":19207,"_19208":19209,"_19210":19211,"_19212":19213,"_19214":19215,"_19216":19217,"_19218":19219,"_19220":19221,"_19222":19223,"_19224":19225,"_19226":19227,"_19228":19229,"_19230":19231,"_19232":19233,"_19234":19235,"_19236":19237,"_19238":19239,"_19240":19241,"_19242":19243,"_19244":19245,"_19246":19247,"_19248":19249,"_19250":19251,"_19252":19253,"_19254":19255,"_19256":19257,"_19258":19259,"_19260":19261,"_19262":19263,"_19264":19265,"_19266":19267,"_19268":19269,"_19270":19271,"_19272":19273,"_19274":19275,"_19276":19277,"_19278":19279,"_19280":19281,"_19282":19283,"_19284":19285,"_19286":19287,"_19288":19289,"_19290":19291,"_19292":19293,"_19294":19295,"_19296":19297,"_19298":19299,"_19300":19301,"_19302":19303,"_19304":19305,"_19306":19307,"_19308":19309,"_19310":19311,"_19312":19313,"_19314":19315,"_19316":19317,"_19318":19319,"_19320":19321,"_19322":19323,"_19324":19325,"_19326":19327,"_19328":19329,"_19330":19331,"_19332":19333,"_19334":19335,"_19336":19337,"_19338":19339,"_19340":19341,"_19342":19343,"_19344":19345,"_19346":19347,"_19348":19349,"_19350":19351},"document.generationInfo.generation",[18109],"bigint","dehydratedState.queries.0.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.1.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.1.queryKey.2",[18116],"undefined","dehydratedState.queries.2.state.data.0.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.0.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.0.sortTime",[18123],"Date","dehydratedState.queries.2.state.data.0.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.0.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.0.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.0.redirectInfo",[18116],"dehydratedState.queries.2.state.data.1.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.1.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.1.sortTime",[18123],"dehydratedState.queries.2.state.data.1.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.1.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.1.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.1.redirectInfo",[18116],"dehydratedState.queries.2.state.data.2.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.2.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.2.sortTime",[18123],"dehydratedState.queries.2.state.data.2.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.2.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.2.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.2.redirectInfo",[18116],"dehydratedState.queries.2.state.data.3.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.3.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.3.sortTime",[18123],"dehydratedState.queries.2.state.data.3.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.3.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.3.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.3.redirectInfo",[18116],"dehydratedState.queries.2.state.data.4.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.4.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.4.sortTime",[18123],"dehydratedState.queries.2.state.data.4.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.4.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.4.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.4.redirectInfo",[18116],"dehydratedState.queries.2.state.data.5.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.5.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.5.sortTime",[18123],"dehydratedState.queries.2.state.data.5.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.2.state.data.5.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.5.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.5.redirectInfo",[18116],"dehydratedState.queries.2.state.data.6.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.6.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.6.sortTime",[18123],"dehydratedState.queries.2.state.data.6.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.2.state.data.6.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.6.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.6.redirectInfo",[18116],"dehydratedState.queries.2.state.data.7.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.7.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.7.sortTime",[18123],"dehydratedState.queries.2.state.data.7.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.7.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.7.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.7.redirectInfo",[18116],"dehydratedState.queries.2.state.data.8.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.8.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.8.sortTime",[18123],"dehydratedState.queries.2.state.data.8.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.8.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.8.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.8.redirectInfo",[18116],"dehydratedState.queries.2.state.data.9.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.9.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.9.sortTime",[18123],"dehydratedState.queries.2.state.data.9.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.2.state.data.9.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.9.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.9.redirectInfo",[18116],"dehydratedState.queries.2.state.data.10.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.10.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.10.sortTime",[18123],"dehydratedState.queries.2.state.data.10.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.2.state.data.10.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.10.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.10.redirectInfo",[18116],"dehydratedState.queries.2.state.data.11.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.11.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.11.sortTime",[18123],"dehydratedState.queries.2.state.data.11.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.2.state.data.11.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.11.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.11.redirectInfo",[18116],"dehydratedState.queries.2.state.data.12.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.12.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.12.sortTime",[18123],"dehydratedState.queries.2.state.data.12.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.12.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.12.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.12.redirectInfo",[18116],"dehydratedState.queries.2.state.data.13.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.13.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.13.sortTime",[18123],"dehydratedState.queries.2.state.data.13.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.13.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.13.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.13.redirectInfo",[18116],"dehydratedState.queries.2.state.data.14.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.14.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.14.sortTime",[18123],"dehydratedState.queries.2.state.data.14.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.14.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.14.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.14.redirectInfo",[18116],"dehydratedState.queries.2.state.data.15.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.15.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.15.sortTime",[18123],"dehydratedState.queries.2.state.data.15.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.2.state.data.15.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.15.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.15.redirectInfo",[18116],"dehydratedState.queries.2.state.data.16.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.16.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.16.sortTime",[18123],"dehydratedState.queries.2.state.data.16.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.16.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.16.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.16.redirectInfo",[18116],"dehydratedState.queries.2.state.data.17.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.17.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.17.sortTime",[18123],"dehydratedState.queries.2.state.data.17.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.17.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.17.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.17.redirectInfo",[18116],"dehydratedState.queries.2.state.data.18.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.18.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.18.sortTime",[18123],"dehydratedState.queries.2.state.data.18.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.18.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.18.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.18.redirectInfo",[18116],"dehydratedState.queries.2.state.data.19.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.19.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.19.sortTime",[18123],"dehydratedState.queries.2.state.data.19.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.2.state.data.19.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.19.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.19.redirectInfo",[18116],"dehydratedState.queries.2.state.data.20.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.20.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.20.sortTime",[18123],"dehydratedState.queries.2.state.data.20.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.2.state.data.20.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.20.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.20.redirectInfo",[18116],"dehydratedState.queries.2.state.data.21.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.21.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.21.sortTime",[18123],"dehydratedState.queries.2.state.data.21.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.21.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.21.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.21.redirectInfo",[18116],"dehydratedState.queries.2.state.data.22.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.22.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.22.sortTime",[18123],"dehydratedState.queries.2.state.data.22.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.22.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.22.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.22.redirectInfo",[18116],"dehydratedState.queries.2.state.data.23.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.23.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.23.sortTime",[18123],"dehydratedState.queries.2.state.data.23.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.2.state.data.23.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.23.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.23.redirectInfo",[18116],"dehydratedState.queries.2.state.data.24.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.24.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.24.sortTime",[18123],"dehydratedState.queries.2.state.data.24.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.2.state.data.24.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.24.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.24.redirectInfo",[18116],"dehydratedState.queries.2.state.data.25.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.25.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.25.sortTime",[18123],"dehydratedState.queries.2.state.data.25.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.2.state.data.25.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.25.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.25.redirectInfo",[18116],"dehydratedState.queries.2.state.data.26.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.26.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.26.sortTime",[18123],"dehydratedState.queries.2.state.data.26.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.2.state.data.26.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.26.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.26.redirectInfo",[18116],"dehydratedState.queries.2.state.data.27.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.27.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.27.sortTime",[18123],"dehydratedState.queries.2.state.data.27.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.2.state.data.27.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.27.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.27.redirectInfo",[18116],"dehydratedState.queries.2.state.data.28.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.28.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.28.sortTime",[18123],"dehydratedState.queries.2.state.data.28.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.28.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.28.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.28.redirectInfo",[18116],"dehydratedState.queries.2.state.data.29.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.29.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.29.sortTime",[18123],"dehydratedState.queries.2.state.data.29.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.2.state.data.29.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.29.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.29.redirectInfo",[18116],"dehydratedState.queries.2.state.data.30.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.30.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.30.sortTime",[18123],"dehydratedState.queries.2.state.data.30.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.30.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.30.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.30.redirectInfo",[18116],"dehydratedState.queries.2.state.data.31.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.31.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.31.sortTime",[18123],"dehydratedState.queries.2.state.data.31.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.2.state.data.31.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.31.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.31.redirectInfo",[18116],"dehydratedState.queries.2.state.data.32.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.32.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.32.sortTime",[18123],"dehydratedState.queries.2.state.data.32.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.2.state.data.32.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.32.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.32.redirectInfo",[18116],"dehydratedState.queries.2.state.data.33.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.33.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.33.sortTime",[18123],"dehydratedState.queries.2.state.data.33.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.33.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.33.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.33.redirectInfo",[18116],"dehydratedState.queries.2.state.data.34.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.34.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.34.sortTime",[18123],"dehydratedState.queries.2.state.data.34.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.34.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.34.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.34.redirectInfo",[18116],"dehydratedState.queries.2.state.data.35.createTime.seconds",[18109],"dehydratedState.queries.2.state.data.35.updateTime.seconds",[18109],"dehydratedState.queries.2.state.data.35.sortTime",[18123],"dehydratedState.queries.2.state.data.35.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.2.state.data.35.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.2.state.data.35.generationInfo.generation",[18109],"dehydratedState.queries.2.state.data.35.redirectInfo",[18116],"dehydratedState.queries.3.state.data.0.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.0.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.0.sortTime",[18123],"dehydratedState.queries.3.state.data.0.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.0.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.0.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.0.redirectInfo",[18116],"dehydratedState.queries.3.state.data.1.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.1.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.1.sortTime",[18123],"dehydratedState.queries.3.state.data.1.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.1.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.1.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.1.redirectInfo",[18116],"dehydratedState.queries.3.state.data.2.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.2.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.2.sortTime",[18123],"dehydratedState.queries.3.state.data.2.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.2.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.2.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.2.redirectInfo",[18116],"dehydratedState.queries.3.state.data.3.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.3.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.3.sortTime",[18123],"dehydratedState.queries.3.state.data.3.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.3.state.data.3.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.3.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.3.redirectInfo",[18116],"dehydratedState.queries.3.state.data.4.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.4.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.4.sortTime",[18123],"dehydratedState.queries.3.state.data.4.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.4.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.4.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.4.redirectInfo",[18116],"dehydratedState.queries.3.state.data.5.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.5.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.5.sortTime",[18123],"dehydratedState.queries.3.state.data.5.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.5.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.5.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.5.redirectInfo",[18116],"dehydratedState.queries.3.state.data.6.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.6.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.6.sortTime",[18123],"dehydratedState.queries.3.state.data.6.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.6.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.6.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.6.redirectInfo",[18116],"dehydratedState.queries.3.state.data.7.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.7.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.7.sortTime",[18123],"dehydratedState.queries.3.state.data.7.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.7.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.7.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.7.redirectInfo",[18116],"dehydratedState.queries.3.state.data.8.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.8.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.8.sortTime",[18123],"dehydratedState.queries.3.state.data.8.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.8.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.8.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.8.redirectInfo",[18116],"dehydratedState.queries.3.state.data.9.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.9.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.9.sortTime",[18123],"dehydratedState.queries.3.state.data.9.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.3.state.data.9.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.9.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.9.redirectInfo",[18116],"dehydratedState.queries.3.state.data.10.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.10.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.10.sortTime",[18123],"dehydratedState.queries.3.state.data.10.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.10.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.10.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.10.redirectInfo",[18116],"dehydratedState.queries.3.state.data.11.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.11.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.11.sortTime",[18123],"dehydratedState.queries.3.state.data.11.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.11.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.11.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.11.redirectInfo",[18116],"dehydratedState.queries.3.state.data.12.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.12.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.12.sortTime",[18123],"dehydratedState.queries.3.state.data.12.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.12.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.12.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.12.redirectInfo",[18116],"dehydratedState.queries.3.state.data.13.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.13.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.13.sortTime",[18123],"dehydratedState.queries.3.state.data.13.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.13.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.13.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.13.redirectInfo",[18116],"dehydratedState.queries.3.state.data.14.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.14.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.14.sortTime",[18123],"dehydratedState.queries.3.state.data.14.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.14.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.14.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.14.redirectInfo",[18116],"dehydratedState.queries.3.state.data.15.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.15.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.15.sortTime",[18123],"dehydratedState.queries.3.state.data.15.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.15.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.15.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.15.redirectInfo",[18116],"dehydratedState.queries.3.state.data.16.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.16.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.16.sortTime",[18123],"dehydratedState.queries.3.state.data.16.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.16.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.16.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.16.redirectInfo",[18116],"dehydratedState.queries.3.state.data.17.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.17.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.17.sortTime",[18123],"dehydratedState.queries.3.state.data.17.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.17.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.17.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.17.redirectInfo",[18116],"dehydratedState.queries.3.state.data.18.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.18.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.18.sortTime",[18123],"dehydratedState.queries.3.state.data.18.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.3.state.data.18.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.18.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.18.redirectInfo",[18116],"dehydratedState.queries.3.state.data.19.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.19.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.19.sortTime",[18123],"dehydratedState.queries.3.state.data.19.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.19.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.19.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.19.redirectInfo",[18116],"dehydratedState.queries.3.state.data.20.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.20.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.20.sortTime",[18123],"dehydratedState.queries.3.state.data.20.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.3.state.data.20.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.20.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.20.redirectInfo",[18116],"dehydratedState.queries.3.state.data.21.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.21.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.21.sortTime",[18123],"dehydratedState.queries.3.state.data.21.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.3.state.data.21.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.21.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.21.redirectInfo",[18116],"dehydratedState.queries.3.state.data.22.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.22.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.22.sortTime",[18123],"dehydratedState.queries.3.state.data.22.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.22.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.22.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.22.redirectInfo",[18116],"dehydratedState.queries.3.state.data.23.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.23.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.23.sortTime",[18123],"dehydratedState.queries.3.state.data.23.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.23.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.23.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.23.redirectInfo",[18116],"dehydratedState.queries.3.state.data.24.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.24.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.24.sortTime",[18123],"dehydratedState.queries.3.state.data.24.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.24.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.24.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.24.redirectInfo",[18116],"dehydratedState.queries.3.state.data.25.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.25.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.25.sortTime",[18123],"dehydratedState.queries.3.state.data.25.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.25.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.25.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.25.redirectInfo",[18116],"dehydratedState.queries.3.state.data.26.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.26.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.26.sortTime",[18123],"dehydratedState.queries.3.state.data.26.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.26.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.26.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.26.redirectInfo",[18116],"dehydratedState.queries.3.state.data.27.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.27.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.27.sortTime",[18123],"dehydratedState.queries.3.state.data.27.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.27.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.27.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.27.redirectInfo",[18116],"dehydratedState.queries.3.state.data.28.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.28.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.28.sortTime",[18123],"dehydratedState.queries.3.state.data.28.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.3.state.data.28.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.28.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.28.redirectInfo",[18116],"dehydratedState.queries.3.state.data.29.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.29.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.29.sortTime",[18123],"dehydratedState.queries.3.state.data.29.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.29.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.29.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.29.redirectInfo",[18116],"dehydratedState.queries.3.state.data.30.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.30.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.30.sortTime",[18123],"dehydratedState.queries.3.state.data.30.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.30.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.30.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.30.redirectInfo",[18116],"dehydratedState.queries.3.state.data.31.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.31.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.31.sortTime",[18123],"dehydratedState.queries.3.state.data.31.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.31.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.31.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.31.redirectInfo",[18116],"dehydratedState.queries.3.state.data.32.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.32.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.32.sortTime",[18123],"dehydratedState.queries.3.state.data.32.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.32.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.32.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.32.redirectInfo",[18116],"dehydratedState.queries.3.state.data.33.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.33.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.33.sortTime",[18123],"dehydratedState.queries.3.state.data.33.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.3.state.data.33.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.33.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.33.redirectInfo",[18116],"dehydratedState.queries.3.state.data.34.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.34.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.34.sortTime",[18123],"dehydratedState.queries.3.state.data.34.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.34.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.34.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.34.redirectInfo",[18116],"dehydratedState.queries.3.state.data.35.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.35.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.35.sortTime",[18123],"dehydratedState.queries.3.state.data.35.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.35.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.35.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.35.redirectInfo",[18116],"dehydratedState.queries.3.state.data.36.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.36.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.36.sortTime",[18123],"dehydratedState.queries.3.state.data.36.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.3.state.data.36.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.36.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.36.redirectInfo",[18116],"dehydratedState.queries.3.state.data.37.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.37.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.37.sortTime",[18123],"dehydratedState.queries.3.state.data.37.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.3.state.data.37.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.37.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.37.redirectInfo",[18116],"dehydratedState.queries.3.state.data.38.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.38.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.38.sortTime",[18123],"dehydratedState.queries.3.state.data.38.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.38.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.38.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.38.redirectInfo",[18116],"dehydratedState.queries.3.state.data.39.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.39.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.39.sortTime",[18123],"dehydratedState.queries.3.state.data.39.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.3.state.data.39.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.39.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.39.redirectInfo",[18116],"dehydratedState.queries.3.state.data.40.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.40.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.40.sortTime",[18123],"dehydratedState.queries.3.state.data.40.activitySummary.latestCommentTime.seconds",[18109],"dehydratedState.queries.3.state.data.40.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.40.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.40.redirectInfo",[18116],"dehydratedState.queries.3.state.data.41.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.41.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.41.sortTime",[18123],"dehydratedState.queries.3.state.data.41.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.3.state.data.41.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.41.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.41.redirectInfo",[18116],"dehydratedState.queries.3.state.data.42.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.42.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.42.sortTime",[18123],"dehydratedState.queries.3.state.data.42.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.3.state.data.42.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.42.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.42.redirectInfo",[18116],"dehydratedState.queries.3.state.data.43.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.43.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.43.sortTime",[18123],"dehydratedState.queries.3.state.data.43.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.3.state.data.43.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.43.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.43.redirectInfo",[18116],"dehydratedState.queries.3.state.data.44.createTime.seconds",[18109],"dehydratedState.queries.3.state.data.44.updateTime.seconds",[18109],"dehydratedState.queries.3.state.data.44.sortTime",[18123],"dehydratedState.queries.3.state.data.44.activitySummary.latestCommentTime",[18116],"dehydratedState.queries.3.state.data.44.activitySummary.latestChangeTime.seconds",[18109],"dehydratedState.queries.3.state.data.44.generationInfo.generation",[18109],"dehydratedState.queries.3.state.data.44.redirectInfo",[18116],"dehydratedState.queries.5.state.data.metadata.summary",[18116],"dehydratedState.queries.6.state.data.metadata.summary",[18116],"dehydratedState.queries.7.state.data.metadata.summary",[18116],"dehydratedState.queries.8.state.data.metadata.summary",[18116],"dehydratedState.queries.9.state.data.metadata.summary",[18116],"dehydratedState.queries.10.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.11.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.12.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.13.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.14.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.15.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.16.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.17.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.18.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.19.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.20.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.21.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.22.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.23.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.24.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.25.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.26.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.27.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.28.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.29.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.30.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.31.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.32.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.33.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.34.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.35.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.36.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.37.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.38.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.39.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.40.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.41.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.42.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.43.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.44.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.45.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.46.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.47.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.48.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.49.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.50.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.51.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.52.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.53.state.data.document.generationInfo.generation",[18109],"dehydratedState.queries.54.state.data.document.generationInfo.generation",[18109],"referentialEqualities",{"_18107":19354,"_18112":19355,"_18119":19356,"_18134":19357,"_18148":19358,"_18162":19359,"_18176":19360,"_18188":19361,"_18202":19362,"_18218":19363,"_18232":19364,"_18244":19365,"_18258":19366,"_18272":19367,"_18288":19368,"_18302":19369,"_18316":19370,"_18328":19371,"_18344":19372,"_18358":19373,"_18372":19374,"_18386":19375,"_18398":19376,"_18414":19377,"_18428":19378,"_18442":19379,"_18456":19380,"_18468":19381,"_18484":19382,"_18498":19383,"_18512":19384,"_18526":19385,"_18540":19386,"_18552":19387,"_18568":19388,"_18582":19389,"_18596":19390,"_18610":19391,"_18624":19392,"_18632":19393,"_18636":19394,"_18646":19395,"_18650":19396,"_18660":19397,"_18664":19398,"_18674":19399,"_18678":19400,"_18688":19401,"_18694":19402,"_18702":19403,"_18708":19404,"_18716":19405,"_18722":19406,"_18730":19407,"_18734":19408,"_18744":19409,"_18750":19410,"_18758":19411,"_18762":19412,"_18772":19413,"_18778":19414,"_18786":19415,"_18792":19416,"_18800":19417,"_18806":19418,"_18814":19419,"_18818":19420,"_18828":19421,"_18832":19422,"_18842":19423,"_18848":19424,"_18856":19425,"_18860":19426,"_18870":19427,"_18874":19428,"_18884":19429,"_18888":19430,"_18898":19431,"_18902":19432,"_18912":19433,"_18918":19434,"_18926":19435,"_18930":19436,"_18940":19437,"_18944":19438,"_18954":19439,"_18958":19440,"_18968":19441,"_18972":19442,"_18982":19443,"_18988":19444,"_18996":19445,"_19002":19446,"_19010":19447,"_19016":19448,"_19024":19449,"_19028":19450,"_19038":19451,"_19042":19452,"_19052":19453,"_19056":19454,"_19066":19455,"_19070":19456,"_19080":19457,"_19084":19458,"_19094":19459,"_19098":19460,"_19108":19461,"_19112":19462,"_19122":19463,"_19126":19464,"_19136":19465,"_19140":19466,"_19150":19467,"_19156":19468,"_19164":19469,"_19170":19470,"_19178":19471,"_19182":19472,"_19192":19473,"_19198":19474,"_19206":19475,"_19210":19476,"_19220":19477,"_19224":19478,"_19234":19479,"_19238":19480,"_19248":19481},[18110,18142],[18128,18174,18436,18548,18720,18748,18790],[18126],[18140],[18154],[18168],[18182],[18190,18196],[18204,18210],[18224],[18238],[18246,18252],[18260,18266],[18274,18280],[18294],[18308],[18322],[18330,18336],[18350],[18364],[18378],[18392],[18400,18406],[18420],[18434],[18448],[18462],[18470,18476],[18490],[18504],[18518],[18532],[18546],[18554,18560],[18574],[18588],[18602],[18616],[18630],[19262],[18638,18644],[19268],[18652,18658],[19266],[18666,18672],[19272],[18680,18686],[19270],[18700],[19274],[18714],[19276],[18728],[19280],[18736,18742],[19264],[18756],[19282],[18764,18770],[19284],[18784],[19286],[18798],[19292],[18812],[19294],[18820,18826],[19296],[18834,18840],[19298],[18854],[19290],[18862,18868],[19300],[18876,18882],[19302],[18890,18896],[19306],[18904,18910],[19308],[18924],[19312],[18932,18938],[19310],[18946,18952],[19288],[18960,18966],[19304],[18974,18980],[19314],[18994],[19316],[19008],[19318],[19022],[19320],[19030,19036],[19322],[19044,19050],[19324],[19058,19064],[19326],[19072,19078],[19328],[19086,19092],[19330],[19100,19106],[19278],[19114,19120],[19332],[19128,19134],[19334],[19142,19148],[19336],[19162],[19338],[19176],[19340],[19184,19190],[19342],[19204],[19344],[19212,19218],[19346],[19226,19232],[19348],[19240,19246],[19350],"actionData","errors"]