@warp-drive-mirror/experiments 0.0.1-alpha.97

package/CHANGELOG.md

@@ -0,0 +1 @@
+# @warp-drive-mirror/experiments Changelog

package/LICENSE.md

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+
+Copyright (C) 2024 EmberData and WarpDrive contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/NCC-1701-a-blue.svg

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="1200pt" height="1200pt" version="1.1" viewBox="0 0 1200 1200" xmlns="http://www.w3.org/2000/svg">
+ <path fill="#0969da" d="m1096.3 402.82c-53.148-53.008-117.12-79.516-191.93-79.516-67.488 0-126.55 21.938-177.16 65.805-50.617 43.871-80.988 98.285-91.113 163.25l53.57 4.2188c14.625 0.28125 25.449 6.75 32.48 19.406h18.984c11.809 0 17.715 5.7617 17.715 17.293s-5.9062 17.293-17.715 17.293h-17.297c-6.75 14.344-18.137 21.797-34.168 22.359l-53.57 4.6406c10.125 64.68 40.496 118.95 91.113 162.82 50.617 43.871 109.68 65.805 177.16 65.805 74.805 0 138.78-26.574 191.93-79.723 53.152-53.148 79.727-116.98 79.727-191.51 0-75.086-26.574-139.13-79.727-192.14zm-79.422 185.27c0 2.9531 2.3906 5.3477 5.3438 5.3477 2.9531 0 5.3477-2.3945 5.3477-5.3477 0-2.9492-2.3945-5.3438-5.3477-5.3438-2.9531 0-5.3438 2.3945-5.3438 5.3438zm-104.54-111.07c0 2.9531 2.3945 5.3477 5.3438 5.3477 2.9531 0 5.3477-2.3945 5.3477-5.3477s-2.3945-5.3438-5.3477-5.3438c-2.9492 0-5.3438 2.3906-5.3438 5.3438zm-12.473 0c0 2.9531 2.3906 5.3477 5.3438 5.3477s5.3477-2.3945 5.3477-5.3477-2.3945-5.3438-5.3477-5.3438-5.3438 2.3906-5.3438 5.3438zm117.01 123.55c0 2.9492 2.3906 5.3438 5.3438 5.3438 2.9531 0 5.3477-2.3945 5.3477-5.3438 0-2.9531-2.3945-5.3477-5.3477-5.3477-2.9531 0-5.3438 2.3945-5.3438 5.3477zm-104.54 111.66c0 2.9531 2.3945 5.3477 5.3438 5.3477 2.9531 0 5.3477-2.3945 5.3477-5.3477s-2.3945-5.3438-5.3477-5.3438c-2.9492 0-5.3438 2.3906-5.3438 5.3438zm-12.473 0c0 2.9531 2.3906 5.3477 5.3438 5.3477s5.3477-2.3945 5.3477-5.3477-2.3945-5.3438-5.3477-5.3438-5.3438 2.3906-5.3438 5.3438zm-848-318.48c14.062-2.5312 30.934-4.5 50.621-5.9062l-46.402-0.84375zm499.86 169.15c-8.7188-2.25-18.141-8.7188-28.266-19.402l-101.23-103.35h-111.36l173.79 126.12v4.2188c21.652 6.1836 44.008 3.6562 67.07-7.5938zm47.664-148.48c-0.84375 3.3711-2.8125 6.6055-5.9062 9.6992h-5.0625l-6.3242-5.0625h-79.305v-4.6367zm-5.9062-16.031c3.0938 3.0938 5.0625 6.4688 5.9062 10.125h-96.598v-4.6406h79.305l6.3242-5.4844zm-541.62 397.78 4.2188 6.7461 46.402-0.84375c-22.5-2.2461-39.371-4.2148-50.621-5.9023zm499.86-169.15c-23.062-11.531-45.418-14.062-67.07-7.5938v4.2188l-173.79 126.12h111.36l101.23-103.77c10.406-10.684 19.828-17.012 28.266-18.98zm47.664 148.48h-96.598v-4.6406h79.305l6.3242-5.4805h5.0625c3.0938 3.6523 5.0625 7.0273 5.9062 10.121zm-5.9062 15.609h-5.0625l-6.3242-5.0625h-79.305v-4.6406h96.598c-0.84375 3.0938-2.8125 6.3281-5.9062 9.7031zm-102.5 9.6992c3.6562 1.4062 7.4531 2.1094 11.391 2.1094h64.961c24.746 0 37.121-8.4336 37.121-25.309 0-8.4375-4.6406-14.691-13.922-18.77-9.2773-4.0781-17.012-6.1172-23.199-6.1172h-64.961c-4.7812 0-8.5781 0.5625-11.391 1.6875h-333.66c-5.0625 0-28.543 1.6172-70.445 4.8516-41.902 3.2344-62.852 7.3828-62.852 12.441v11.812c0 4.5 20.949 8.5078 62.852 12.023 41.902 3.5156 65.383 5.2695 70.445 5.2695zm125.28-207.54h-42.602c-3.375 1.125-3.375 2.25 0 3.375h42.602zm-43.445 8.4375h-5.4844v-13.5h5.4844c17.152-6.1875 33.605-9.9844 49.352-11.391l4.6406-25.309 4.6406 0.42188c0.5625-4.2188 1.6875-10.262 3.375-18.137-28.684-0.5625-64.398 1.6875-107.14 6.75 3.6562 4.2148 7.4531 7.8711 11.391 10.965 4.7812 3.375 9.4219 5.625 13.918 6.75l12.656 2.9531-11.812 5.9062c-13.496 6.75-30.23 10.121-50.195 10.121-5.0625 0-8.5781-0.14062-10.547-0.42188-4.2188-0.5625-7.5898-1.1211-10.121-1.6836l-3.375-1.2656v-5.4844l-24.043-17.297c-41.34 5.625-69.32 8.5781-83.945 8.8594-31.496 0.28125-47.242 11.953-47.242 35.012 0 22.215 15.746 33.887 47.242 35.012 18.844 0.28125 46.824 3.2344 83.945 8.8594l24.043-17.297v-5.4844l3.375-1.2656c2.5312-0.84375 5.9023-1.4062 10.121-1.6875 1.9688-0.28125 5.4844-0.42187 10.547-0.42187 19.965 0 36.699 3.375 50.195 10.125l11.812 5.4844-12.656 3.375c-4.4961 0.84375-9.1367 3.0938-13.918 6.75-3.6562 2.2461-7.4531 5.7617-11.391 10.543 40.777 5.0625 76.492 7.4531 107.14 7.1719-1.6875-7.3125-2.8125-13.359-3.375-18.137h-4.6406l-4.6406-24.891c-17.434-2.25-33.887-6.043-49.352-11.387zm48.508-20.25c-12.652 1.6875-23.762 3.9375-33.324 6.75h29.105l3.7969-4.2188zm-4.2188 20.25h-29.105c9.5625 2.5312 20.672 4.7812 33.324 6.7461l-0.42188-2.5273zm136.67-8.4375c0-8.4375-4.2188-12.656-12.652-12.656h-21.516c-6.4688-12.652-16.59-18.98-30.371-18.98l-58.211-5.0625-5.9062 29.527-4.2188 5.0625v7.5938l4.2188 5.0625 5.9062 29.105 58.211-5.0625c15.469 0 26.012-7.3125 31.637-21.934h20.25c8.4336 0 12.652-4.2188 12.652-12.656zm-46.82 1.6875c0-11.531-5.9062-17.297-17.719-17.297-11.527 0-17.293 5.7656-17.293 17.297 0 11.812 5.7656 17.715 17.293 17.715 11.812 0 17.719-5.9023 17.719-17.715zm4.6406 0c0 14.902-7.4531 22.355-22.359 22.355-14.902 0-22.355-7.4531-22.355-22.355 0-14.906 7.4531-22.355 22.355-22.355 14.906 0 22.359 7.4492 22.359 22.355zm-13.922 0c0-5.625-2.8125-8.4375-8.4375-8.4375-5.3438 0-8.0156 2.8125-8.0156 8.4375s2.6719 8.4375 8.0156 8.4375c5.625 0 8.4375-2.8125 8.4375-8.4375zm4.6406 0c0 8.7188-4.3594 13.078-13.078 13.078-8.4375 0-12.652-4.3594-12.652-13.078s4.2148-13.078 12.652-13.078c8.7188 0 13.078 4.3594 13.078 13.078zm-43.871-2.1094v4.2188h-35.012v-4.2188zm258.58 2.1094c-0.5625-8.4375-4.7812-12.656-12.656-12.656-8.4336 0-12.652 4.2188-12.652 12.656s4.2188 12.656 12.652 12.656c8.4375 0 12.656-4.2188 12.656-12.656zm4.6406 0c0 11.531-5.7656 17.293-17.297 17.293-11.527 0-17.293-5.7617-17.293-17.293s5.7656-17.297 17.293-17.297c11.531 0 17.297 5.7656 17.297 17.297zm32.48 0c0-13.781-4.9219-25.59-14.766-35.434-9.5586-9.5625-21.23-14.344-35.012-14.344-15.184 0-31.777 5.7656-49.773 17.297-18.559 11.531-27.84 22.355-27.84 32.48 0 9.8438 9.2812 20.668 27.84 32.48 17.996 11.531 34.59 17.293 49.773 17.293 13.781 0 25.453-4.918 35.012-14.762 9.8438-9.5625 14.766-21.234 14.766-35.012zm5.0625 0c0 14.902-5.3438 27.699-16.031 38.387-10.684 10.684-23.621 16.027-38.809 16.027-15.746 0-33.18-6.0469-52.305-18.137-20.246-12.656-30.371-24.746-30.371-36.277s10.125-23.762 30.371-36.699c19.125-12.094 36.559-18.137 52.305-18.137 14.625 0 27.562 5.3398 38.809 16.027 10.688 10.969 16.031 23.902 16.031 38.809zm-54.418-29.105c-3.9336 0-10.262 1.6875-18.98 5.0625-7.875 3.9375-11.812 6.4648-11.812 7.5898v32.48c0 3.0938 3.9375 5.625 11.812 7.5938 7.875 3.375 14.203 5.0625 18.98 5.0625 19.406 0 29.391-9.2812 29.953-27.84 0-19.688-9.9844-29.668-29.953-29.949zm34.59 29.105v0.84375c0 21.371-11.527 32.34-34.59 32.902-4.4961 0-11.527-1.8281-21.09-5.4844-7.0312-3.9375-10.969-6.3281-11.809-7.1719-1.6875-1.4062-2.5312-3.0938-2.5312-5.0625v-32.48c0-1.4062 0.70312-2.9492 2.1094-4.6367 3.0898-2.8125 7.168-5.2031 12.23-7.1719 9-3.6562 16.031-5.4844 21.09-5.4844 22.5 0.28125 34.027 11.531 34.59 33.746zm-448.4-206.27h-333.66c-5.0625 0-28.543 1.6875-70.445 5.0625-41.902 3.375-62.852 7.5938-62.852 12.656v11.387c0 4.7812 20.949 8.8594 62.852 12.234 41.902 3.375 65.383 5.0625 70.445 5.0625h333.66c3.6562 1.4062 7.4531 2.1094 11.391 2.1094h64.961c5.3438 0 12.867-2.25 22.566-6.75 9.7031-4.5 14.555-10.547 14.555-18.137 0.28125-16.875-12.094-25.312-37.121-25.312h-64.961c-4.7812 0-8.5781 0.5625-11.391 1.6875z" fill-rule="evenodd"/>
+</svg>

package/NCC-1701-a.svg

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="1200pt" height="1200pt" version="1.1" viewBox="0 0 1200 1200" xmlns="http://www.w3.org/2000/svg">
+ <path fill="#FFFFFF" d="m1096.3 402.82c-53.148-53.008-117.12-79.516-191.93-79.516-67.488 0-126.55 21.938-177.16 65.805-50.617 43.871-80.988 98.285-91.113 163.25l53.57 4.2188c14.625 0.28125 25.449 6.75 32.48 19.406h18.984c11.809 0 17.715 5.7617 17.715 17.293s-5.9062 17.293-17.715 17.293h-17.297c-6.75 14.344-18.137 21.797-34.168 22.359l-53.57 4.6406c10.125 64.68 40.496 118.95 91.113 162.82 50.617 43.871 109.68 65.805 177.16 65.805 74.805 0 138.78-26.574 191.93-79.723 53.152-53.148 79.727-116.98 79.727-191.51 0-75.086-26.574-139.13-79.727-192.14zm-79.422 185.27c0 2.9531 2.3906 5.3477 5.3438 5.3477 2.9531 0 5.3477-2.3945 5.3477-5.3477 0-2.9492-2.3945-5.3438-5.3477-5.3438-2.9531 0-5.3438 2.3945-5.3438 5.3438zm-104.54-111.07c0 2.9531 2.3945 5.3477 5.3438 5.3477 2.9531 0 5.3477-2.3945 5.3477-5.3477s-2.3945-5.3438-5.3477-5.3438c-2.9492 0-5.3438 2.3906-5.3438 5.3438zm-12.473 0c0 2.9531 2.3906 5.3477 5.3438 5.3477s5.3477-2.3945 5.3477-5.3477-2.3945-5.3438-5.3477-5.3438-5.3438 2.3906-5.3438 5.3438zm117.01 123.55c0 2.9492 2.3906 5.3438 5.3438 5.3438 2.9531 0 5.3477-2.3945 5.3477-5.3438 0-2.9531-2.3945-5.3477-5.3477-5.3477-2.9531 0-5.3438 2.3945-5.3438 5.3477zm-104.54 111.66c0 2.9531 2.3945 5.3477 5.3438 5.3477 2.9531 0 5.3477-2.3945 5.3477-5.3477s-2.3945-5.3438-5.3477-5.3438c-2.9492 0-5.3438 2.3906-5.3438 5.3438zm-12.473 0c0 2.9531 2.3906 5.3477 5.3438 5.3477s5.3477-2.3945 5.3477-5.3477-2.3945-5.3438-5.3477-5.3438-5.3438 2.3906-5.3438 5.3438zm-848-318.48c14.062-2.5312 30.934-4.5 50.621-5.9062l-46.402-0.84375zm499.86 169.15c-8.7188-2.25-18.141-8.7188-28.266-19.402l-101.23-103.35h-111.36l173.79 126.12v4.2188c21.652 6.1836 44.008 3.6562 67.07-7.5938zm47.664-148.48c-0.84375 3.3711-2.8125 6.6055-5.9062 9.6992h-5.0625l-6.3242-5.0625h-79.305v-4.6367zm-5.9062-16.031c3.0938 3.0938 5.0625 6.4688 5.9062 10.125h-96.598v-4.6406h79.305l6.3242-5.4844zm-541.62 397.78 4.2188 6.7461 46.402-0.84375c-22.5-2.2461-39.371-4.2148-50.621-5.9023zm499.86-169.15c-23.062-11.531-45.418-14.062-67.07-7.5938v4.2188l-173.79 126.12h111.36l101.23-103.77c10.406-10.684 19.828-17.012 28.266-18.98zm47.664 148.48h-96.598v-4.6406h79.305l6.3242-5.4805h5.0625c3.0938 3.6523 5.0625 7.0273 5.9062 10.121zm-5.9062 15.609h-5.0625l-6.3242-5.0625h-79.305v-4.6406h96.598c-0.84375 3.0938-2.8125 6.3281-5.9062 9.7031zm-102.5 9.6992c3.6562 1.4062 7.4531 2.1094 11.391 2.1094h64.961c24.746 0 37.121-8.4336 37.121-25.309 0-8.4375-4.6406-14.691-13.922-18.77-9.2773-4.0781-17.012-6.1172-23.199-6.1172h-64.961c-4.7812 0-8.5781 0.5625-11.391 1.6875h-333.66c-5.0625 0-28.543 1.6172-70.445 4.8516-41.902 3.2344-62.852 7.3828-62.852 12.441v11.812c0 4.5 20.949 8.5078 62.852 12.023 41.902 3.5156 65.383 5.2695 70.445 5.2695zm125.28-207.54h-42.602c-3.375 1.125-3.375 2.25 0 3.375h42.602zm-43.445 8.4375h-5.4844v-13.5h5.4844c17.152-6.1875 33.605-9.9844 49.352-11.391l4.6406-25.309 4.6406 0.42188c0.5625-4.2188 1.6875-10.262 3.375-18.137-28.684-0.5625-64.398 1.6875-107.14 6.75 3.6562 4.2148 7.4531 7.8711 11.391 10.965 4.7812 3.375 9.4219 5.625 13.918 6.75l12.656 2.9531-11.812 5.9062c-13.496 6.75-30.23 10.121-50.195 10.121-5.0625 0-8.5781-0.14062-10.547-0.42188-4.2188-0.5625-7.5898-1.1211-10.121-1.6836l-3.375-1.2656v-5.4844l-24.043-17.297c-41.34 5.625-69.32 8.5781-83.945 8.8594-31.496 0.28125-47.242 11.953-47.242 35.012 0 22.215 15.746 33.887 47.242 35.012 18.844 0.28125 46.824 3.2344 83.945 8.8594l24.043-17.297v-5.4844l3.375-1.2656c2.5312-0.84375 5.9023-1.4062 10.121-1.6875 1.9688-0.28125 5.4844-0.42187 10.547-0.42187 19.965 0 36.699 3.375 50.195 10.125l11.812 5.4844-12.656 3.375c-4.4961 0.84375-9.1367 3.0938-13.918 6.75-3.6562 2.2461-7.4531 5.7617-11.391 10.543 40.777 5.0625 76.492 7.4531 107.14 7.1719-1.6875-7.3125-2.8125-13.359-3.375-18.137h-4.6406l-4.6406-24.891c-17.434-2.25-33.887-6.043-49.352-11.387zm48.508-20.25c-12.652 1.6875-23.762 3.9375-33.324 6.75h29.105l3.7969-4.2188zm-4.2188 20.25h-29.105c9.5625 2.5312 20.672 4.7812 33.324 6.7461l-0.42188-2.5273zm136.67-8.4375c0-8.4375-4.2188-12.656-12.652-12.656h-21.516c-6.4688-12.652-16.59-18.98-30.371-18.98l-58.211-5.0625-5.9062 29.527-4.2188 5.0625v7.5938l4.2188 5.0625 5.9062 29.105 58.211-5.0625c15.469 0 26.012-7.3125 31.637-21.934h20.25c8.4336 0 12.652-4.2188 12.652-12.656zm-46.82 1.6875c0-11.531-5.9062-17.297-17.719-17.297-11.527 0-17.293 5.7656-17.293 17.297 0 11.812 5.7656 17.715 17.293 17.715 11.812 0 17.719-5.9023 17.719-17.715zm4.6406 0c0 14.902-7.4531 22.355-22.359 22.355-14.902 0-22.355-7.4531-22.355-22.355 0-14.906 7.4531-22.355 22.355-22.355 14.906 0 22.359 7.4492 22.359 22.355zm-13.922 0c0-5.625-2.8125-8.4375-8.4375-8.4375-5.3438 0-8.0156 2.8125-8.0156 8.4375s2.6719 8.4375 8.0156 8.4375c5.625 0 8.4375-2.8125 8.4375-8.4375zm4.6406 0c0 8.7188-4.3594 13.078-13.078 13.078-8.4375 0-12.652-4.3594-12.652-13.078s4.2148-13.078 12.652-13.078c8.7188 0 13.078 4.3594 13.078 13.078zm-43.871-2.1094v4.2188h-35.012v-4.2188zm258.58 2.1094c-0.5625-8.4375-4.7812-12.656-12.656-12.656-8.4336 0-12.652 4.2188-12.652 12.656s4.2188 12.656 12.652 12.656c8.4375 0 12.656-4.2188 12.656-12.656zm4.6406 0c0 11.531-5.7656 17.293-17.297 17.293-11.527 0-17.293-5.7617-17.293-17.293s5.7656-17.297 17.293-17.297c11.531 0 17.297 5.7656 17.297 17.297zm32.48 0c0-13.781-4.9219-25.59-14.766-35.434-9.5586-9.5625-21.23-14.344-35.012-14.344-15.184 0-31.777 5.7656-49.773 17.297-18.559 11.531-27.84 22.355-27.84 32.48 0 9.8438 9.2812 20.668 27.84 32.48 17.996 11.531 34.59 17.293 49.773 17.293 13.781 0 25.453-4.918 35.012-14.762 9.8438-9.5625 14.766-21.234 14.766-35.012zm5.0625 0c0 14.902-5.3438 27.699-16.031 38.387-10.684 10.684-23.621 16.027-38.809 16.027-15.746 0-33.18-6.0469-52.305-18.137-20.246-12.656-30.371-24.746-30.371-36.277s10.125-23.762 30.371-36.699c19.125-12.094 36.559-18.137 52.305-18.137 14.625 0 27.562 5.3398 38.809 16.027 10.688 10.969 16.031 23.902 16.031 38.809zm-54.418-29.105c-3.9336 0-10.262 1.6875-18.98 5.0625-7.875 3.9375-11.812 6.4648-11.812 7.5898v32.48c0 3.0938 3.9375 5.625 11.812 7.5938 7.875 3.375 14.203 5.0625 18.98 5.0625 19.406 0 29.391-9.2812 29.953-27.84 0-19.688-9.9844-29.668-29.953-29.949zm34.59 29.105v0.84375c0 21.371-11.527 32.34-34.59 32.902-4.4961 0-11.527-1.8281-21.09-5.4844-7.0312-3.9375-10.969-6.3281-11.809-7.1719-1.6875-1.4062-2.5312-3.0938-2.5312-5.0625v-32.48c0-1.4062 0.70312-2.9492 2.1094-4.6367 3.0898-2.8125 7.168-5.2031 12.23-7.1719 9-3.6562 16.031-5.4844 21.09-5.4844 22.5 0.28125 34.027 11.531 34.59 33.746zm-448.4-206.27h-333.66c-5.0625 0-28.543 1.6875-70.445 5.0625-41.902 3.375-62.852 7.5938-62.852 12.656v11.387c0 4.7812 20.949 8.8594 62.852 12.234 41.902 3.375 65.383 5.0625 70.445 5.0625h333.66c3.6562 1.4062 7.4531 2.1094 11.391 2.1094h64.961c5.3438 0 12.867-2.25 22.566-6.75 9.7031-4.5 14.555-10.547 14.555-18.137 0.28125-16.875-12.094-25.312-37.121-25.312h-64.961c-4.7812 0-8.5781 0.5625-11.391 1.6875z" fill-rule="evenodd"/>
+</svg>

package/README.md

@@ -0,0 +1,33 @@
+<p align="center">
+  <img
+    class="project-logo"
+    src="./NCC-1701-a-blue.svg#gh-light-mode-only"
+    alt="WarpDrive"
+    width="120px"
+    title="WarpDrive" />
+  <img
+    class="project-logo"
+    src="./NCC-1701-a.svg#gh-dark-mode-only"
+    alt="WarpDrive"
+    width="120px"
+    title="WarpDrive" />
+</p>
+
+<h3 align="center">Experiments that may or may not make it into the project core</h3>
+<p align="center">Ideal for Having Fun</p>
+
+> ⚠️ ***Experimental*** ⚠️
+
+## Installation
+
+Install using your javascript package manager of choice. For instance with [pnpm](https://pnpm.io/)
+
+```no-highlight
+pnpm add @warp-drive-mirror/experiments
+```
+
+## Current Experiments
+
+- [PersistedCache](./src/data-worker/README.md)
+- [DocumentStorage](./src/document-storage/README.md)
+- [PersistedCache](./src/persisted-cache/README.md)

package/dist/data-worker.js

@@ -0,0 +1,281 @@
+import { SkipCache } from '@warp-drive-mirror/core-types/request';
+import { macroCondition, getGlobalConfig } from '@embroider/macros';
+class DataWorker {
+  constructor(UserStore) {
+    this.store = new UserStore();
+    this.threads = new Map();
+    this.pending = new Map();
+    this.initialize();
+  }
+  initialize() {
+    globalThis.onmessage = event => {
+      const {
+        type
+      } = event.data;
+      switch (type) {
+        case 'connect':
+          this.setupThread(event.data.thread, event.ports[0]);
+          break;
+      }
+    };
+  }
+  setupThread(thread, port) {
+    this.threads.set(thread, port);
+    this.pending.set(thread, new Map());
+    port.onmessage = event => {
+      if (event.type === 'close') {
+        this.threads.delete(thread);
+        return;
+      }
+      const {
+        type
+      } = event.data;
+      switch (type) {
+        case 'abort':
+          this.abortRequest(event.data);
+          break;
+        case 'request':
+          void this.request(event.data);
+          break;
+      }
+    };
+  }
+  abortRequest(event) {
+    const {
+      thread,
+      id
+    } = event;
+    const future = this.pending.get(thread).get(id);
+    if (future) {
+      future.abort();
+      this.pending.get(thread).delete(id);
+    }
+  }
+  async request(event) {
+    const {
+      thread,
+      id,
+      data
+    } = event;
+    try {
+      const future = this.store.request(data);
+      this.pending.get(thread).set(id, future);
+      const result = await future;
+      this.threads.get(thread)?.postMessage({
+        type: 'success-response',
+        id,
+        thread,
+        data: prepareResponse(result)
+      });
+    } catch (error) {
+      if (isAbortError(error)) return;
+      this.threads.get(thread)?.postMessage({
+        type: 'error-response',
+        id,
+        thread,
+        data: error
+      });
+    } finally {
+      this.pending.get(thread).delete(id);
+    }
+  }
+}
+function softCloneResponse(response) {
+  if (!response) return null;
+  const clone = {};
+  if (response.headers) {
+    clone.headers = {};
+    for (const [key, value] of response.headers.entries()) {
+      clone.headers[key] = value;
+    }
+  }
+  clone.ok = response.ok;
+  clone.redirected = response.redirected;
+  clone.status = response.status;
+  clone.statusText = response.statusText;
+  clone.type = response.type;
+  clone.url = response.url;
+  return clone;
+}
+function isAbortError(error) {
+  return error instanceof Error && error.name === 'AbortError';
+}
+function prepareResponse(result) {
+  const newResponse = {
+    response: softCloneResponse(result.response),
+    content: result.content
+  };
+  return newResponse;
+}
+const MUTATION_OPS = new Set(['createRecord', 'updateRecord', 'deleteRecord']);
+
+/**
+ * In a Worker, any time we are asked to make a request, data needs to be returned.
+ * background requests are ergo no different than foreground requests.
+ * @internal
+ */
+function calcShouldFetch(store, request, hasCachedValue, identifier) {
+  const {
+    cacheOptions
+  } = request;
+  return request.op && MUTATION_OPS.has(request.op) || cacheOptions?.reload || cacheOptions?.backgroundReload || !hasCachedValue || (store.lifetimes && identifier ? store.lifetimes.isHardExpired(identifier, store) || store.lifetimes.isSoftExpired(identifier, store) : false);
+}
+function isMutation(request) {
+  return Boolean(request.op && MUTATION_OPS.has(request.op));
+}
+function isCacheAffecting(document) {
+  if (!isMutation(document.request)) {
+    return true;
+  }
+  // a mutation combined with a 204 has no cache impact when no known records were involved
+  // a createRecord with a 201 with an empty response and no known records should similarly
+  // have no cache impact
+
+  if (document.request.op === 'createRecord' && document.response?.status === 201) {
+    return document.content ? Object.keys(document.content).length > 0 : false;
+  }
+  return document.response?.status !== 204;
+}
+function isAggregateError(error) {
+  return error instanceof AggregateError || error.name === 'AggregateError' && Array.isArray(error.errors);
+}
+// TODO @runspired, consider if we should deep freeze errors (potentially only in debug) vs cloning them
+function cloneError(error) {
+  const isAggregate = isAggregateError(error);
+  const cloned = isAggregate ? new AggregateError(structuredClone(error.errors), error.message) : new Error(error.message);
+  cloned.stack = error.stack;
+  cloned.error = error.error;
+
+  // copy over enumerable properties
+  Object.assign(cloned, error);
+  return cloned;
+}
+const CacheHandler = {
+  request(context, next) {
+    // if we have no cache or no cache-key skip cache handling
+    if (!context.request.store || context.request.cacheOptions?.[SkipCache]) {
+      return next(context.request);
+    }
+    const {
+      store
+    } = context.request;
+    const identifier = store.identifierCache.getOrCreateDocumentIdentifier(context.request);
+    const peeked = identifier ? store.cache.peekRequest(identifier) : null;
+
+    // In a Worker, any time we are asked to make a request, data needs to be returned.
+    // background requests are ergo no different than foreground requests.
+    if (calcShouldFetch(store, context.request, !!peeked, identifier)) {
+      return fetchContentAndHydrate(next, context, identifier);
+    }
+    macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
+      if (!test) {
+        throw new Error(`Expected a peeked request to be present`);
+      }
+    })(peeked) : {};
+    context.setResponse(peeked.response);
+    if ('error' in peeked) {
+      throw peeked;
+    }
+    return maybeUpdateObjects(store, peeked.content);
+  }
+};
+function maybeUpdateObjects(store, document) {
+  if (!document) {
+    return document;
+  }
+  if (Array.isArray(document.data)) {
+    const data = document.data.map(identifier => {
+      return store.cache.peek(identifier);
+    });
+    return Object.assign({}, document, {
+      data
+    });
+  } else {
+    const data = document.data ? store.cache.peek(document.data) : null;
+    return Object.assign({}, document, {
+      data
+    });
+  }
+}
+function updateCacheForSuccess(store, request, document) {
+  let response = null;
+  if (isMutation(request)) {
+    const record = request.data?.record || request.records?.[0];
+    if (record) {
+      response = store.cache.didCommit(record, document);
+
+      // a mutation combined with a 204 has no cache impact when no known records were involved
+      // a createRecord with a 201 with an empty response and no known records should similarly
+      // have no cache impact
+    } else if (isCacheAffecting(document)) {
+      response = store.cache.put(document);
+    }
+  } else {
+    response = store.cache.put(document);
+  }
+  return maybeUpdateObjects(store, response);
+}
+function handleFetchSuccess(store, request, identifier, document) {
+  let response;
+  store._join(() => {
+    response = updateCacheForSuccess(store, request, document);
+  });
+  if (store.lifetimes?.didRequest) {
+    store.lifetimes.didRequest(request, document.response, identifier, store);
+  }
+  return response;
+}
+function updateCacheForError(store, request, error) {
+  if (isMutation(request)) {
+    // TODO similar to didCommit we should spec this to be similar to cache.put for handling full response
+    // currently we let the response remain undefiend.
+    const errors = error && error.content && typeof error.content === 'object' && 'errors' in error.content && Array.isArray(error.content.errors) ? error.content.errors : undefined;
+    const record = request.data?.record || request.records?.[0];
+    store.cache.commitWasRejected(record, errors);
+  } else {
+    return store.cache.put(error);
+  }
+}
+function handleFetchError(store, request, identifier, error) {
+  if (request.signal?.aborted) {
+    throw error;
+  }
+  let response;
+  store._join(() => {
+    response = updateCacheForError(store, request, error);
+  });
+  if (identifier && store.lifetimes?.didRequest) {
+    store.lifetimes.didRequest(request, error.response, identifier, store);
+  }
+  if (isMutation(request)) {
+    throw error;
+  }
+  const newError = cloneError(error);
+  newError.content = response;
+  throw newError;
+}
+function fetchContentAndHydrate(next, context, identifier) {
+  const {
+    request
+  } = context;
+  const {
+    store
+  } = context.request;
+  if (isMutation(request)) {
+    // TODO should we handle multiple records in request.records by iteratively calling willCommit for each
+    const record = request.data?.record || request.records?.[0];
+    macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
+      if (!test) {
+        throw new Error(`Expected to receive a list of records included in the ${request.op} request`);
+      }
+    })(record) : {};
+    if (record) {
+      store.cache.willCommit(record, context);
+    }
+  }
+  if (store.lifetimes?.willRequest) {
+    store.lifetimes.willRequest(request, identifier, store);
+  }
+  return next(request).then(document => handleFetchSuccess(store, request, identifier, document), error => handleFetchError(store, request, identifier, error));
+}
+export { CacheHandler, DataWorker };

package/dist/data-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-worker.js","sources":["../src/data-worker/worker.ts","../src/data-worker/utils.ts","../src/data-worker/cache-handler.ts"],"sourcesContent":["import type { Future, ResponseInfo, StructuredDataDocument } from '@ember-data-mirror/request';\nimport type Store from '@ember-data-mirror/store';\n\nimport type { AbortEventData, RequestEventData, ThreadInitEventData, WorkerThreadEvent } from './types';\n\nexport class DataWorker {\n  declare store: Store;\n  declare threads: Map<string, MessagePort>;\n  declare pending: Map<string, Map<number, Future<unknown>>>;\n\n  constructor(UserStore: typeof Store) {\n    this.store = new UserStore();\n    this.threads = new Map();\n    this.pending = new Map();\n    this.initialize();\n  }\n\n  initialize() {\n    globalThis.onmessage = (event: MessageEvent<ThreadInitEventData>) => {\n      const { type } = event.data;\n\n      switch (type) {\n        case 'connect':\n          this.setupThread(event.data.thread, event.ports[0]);\n          break;\n      }\n    };\n  }\n\n  setupThread(thread: string, port: MessagePort) {\n    this.threads.set(thread, port);\n    this.pending.set(thread, new Map());\n    port.onmessage = (event: WorkerThreadEvent) => {\n      if (event.type === 'close') {\n        this.threads.delete(thread);\n        return;\n      }\n\n      const { type } = event.data;\n      switch (type) {\n        case 'abort':\n          this.abortRequest(event.data);\n          break;\n        case 'request':\n          void this.request(event.data);\n          break;\n      }\n    };\n  }\n\n  abortRequest(event: AbortEventData) {\n    const { thread, id } = event;\n    const future = this.pending.get(thread)!.get(id);\n\n    if (future) {\n      future.abort();\n      this.pending.get(thread)!.delete(id);\n    }\n  }\n\n  async request(event: RequestEventData) {\n    const { thread, id, data } = event;\n\n    try {\n      const future = this.store.request(data);\n      this.pending.get(thread)!.set(id, future);\n\n      const result = await future;\n\n      this.threads.get(thread)?.postMessage({ type: 'success-response', id, thread, data: prepareResponse(result) });\n    } catch (error) {\n      if (isAbortError(error)) return;\n\n      this.threads.get(thread)?.postMessage({ type: 'error-response', id, thread, data: error });\n    } finally {\n      this.pending.get(thread)!.delete(id);\n    }\n  }\n}\n\ntype Mutable<T> = { -readonly [P in keyof T]: T[P] };\n\nfunction softCloneResponse(response: Response | ResponseInfo | null) {\n  if (!response) return null;\n\n  const clone: Partial<Mutable<Omit<Response, 'headers'>>> & { headers?: Record<string, string | number> } = {};\n\n  if (response.headers) {\n    clone.headers = {};\n    for (const [key, value] of response.headers.entries()) {\n      clone.headers[key] = value;\n    }\n  }\n\n  clone.ok = response.ok;\n  clone.redirected = response.redirected;\n  clone.status = response.status;\n  clone.statusText = response.statusText;\n  clone.type = response.type;\n  clone.url = response.url;\n\n  return clone;\n}\n\nfunction isAbortError(error: unknown): error is Error {\n  return error instanceof Error && error.name === 'AbortError';\n}\n\nfunction prepareResponse<T>(result: StructuredDataDocument<T>) {\n  const newResponse = {\n    response: softCloneResponse(result.response),\n    content: result.content,\n  };\n\n  return newResponse;\n}\n","import type Store from '@ember-data-mirror/store';\nimport type { StableDocumentIdentifier } from '@warp-drive-mirror/core-types/identifier';\nimport type {\n  ImmutableCreateRequestOptions,\n  ImmutableDeleteRequestOptions,\n  ImmutableRequestInfo,\n  ImmutableUpdateRequestOptions,\n  StructuredDataDocument,\n} from '@warp-drive-mirror/core-types/request';\nimport type { ApiError } from '@warp-drive-mirror/core-types/spec/error';\n\nexport const MUTATION_OPS = new Set(['createRecord', 'updateRecord', 'deleteRecord']);\n\n/**\n * In a Worker, any time we are asked to make a request, data needs to be returned.\n * background requests are ergo no different than foreground requests.\n * @internal\n */\nexport function calcShouldFetch(\n  store: Store,\n  request: ImmutableRequestInfo,\n  hasCachedValue: boolean,\n  identifier: StableDocumentIdentifier | null\n): boolean {\n  const { cacheOptions } = request;\n  return (\n    (request.op && MUTATION_OPS.has(request.op)) ||\n    cacheOptions?.reload ||\n    cacheOptions?.backgroundReload ||\n    !hasCachedValue ||\n    (store.lifetimes && identifier\n      ? store.lifetimes.isHardExpired(identifier, store) || store.lifetimes.isSoftExpired(identifier, store)\n      : false)\n  );\n}\n\nexport function isMutation(\n  request: Partial<ImmutableRequestInfo>\n): request is ImmutableUpdateRequestOptions | ImmutableCreateRequestOptions | ImmutableDeleteRequestOptions {\n  return Boolean(request.op && MUTATION_OPS.has(request.op));\n}\n\nexport function isCacheAffecting<T>(document: StructuredDataDocument<T>): boolean {\n  if (!isMutation(document.request)) {\n    return true;\n  }\n  // a mutation combined with a 204 has no cache impact when no known records were involved\n  // a createRecord with a 201 with an empty response and no known records should similarly\n  // have no cache impact\n\n  if (document.request.op === 'createRecord' && document.response?.status === 201) {\n    return document.content ? Object.keys(document.content).length > 0 : false;\n  }\n\n  return document.response?.status !== 204;\n}\n\nfunction isAggregateError(error: Error & { errors?: ApiError[] }): error is AggregateError & { errors: ApiError[] } {\n  return error instanceof AggregateError || (error.name === 'AggregateError' && Array.isArray(error.errors));\n}\n\ntype RobustError = Error & { error: string | object; errors?: ApiError[]; content?: unknown };\n\n// TODO @runspired, consider if we should deep freeze errors (potentially only in debug) vs cloning them\nexport function cloneError(error: RobustError) {\n  const isAggregate = isAggregateError(error);\n\n  const cloned = (\n    isAggregate ? new AggregateError(structuredClone(error.errors), error.message) : new Error(error.message)\n  ) as RobustError;\n  cloned.stack = error.stack!;\n  cloned.error = error.error;\n\n  // copy over enumerable properties\n  Object.assign(cloned, error);\n\n  return cloned;\n}\n","import type { CacheHandler as CacheHandlerType, Future, NextFn } from '@ember-data-mirror/request';\nimport type Store from '@ember-data-mirror/store';\nimport type { StoreRequestContext } from '@ember-data-mirror/store';\nimport { assert } from '@warp-drive-mirror/build-config/macros';\nimport type { StableDocumentIdentifier } from '@warp-drive-mirror/core-types/identifier';\nimport type { StructuredDataDocument, StructuredErrorDocument } from '@warp-drive-mirror/core-types/request';\nimport { SkipCache } from '@warp-drive-mirror/core-types/request';\nimport type { ResourceDataDocument, ResourceErrorDocument } from '@warp-drive-mirror/core-types/spec/document';\nimport type { ApiError } from '@warp-drive-mirror/core-types/spec/error';\n\nimport { calcShouldFetch, cloneError, isCacheAffecting, isMutation } from './utils';\n\n/**\n * A simplified CacheHandler that hydrates ResourceDataDocuments from the cache\n * with their referenced resources.\n *\n * @typedoc\n */\nexport const CacheHandler: CacheHandlerType = {\n  request<T>(context: StoreRequestContext, next: NextFn<T>): Promise<T | StructuredDataDocument<T>> | Future<T> | T {\n    // if we have no cache or no cache-key skip cache handling\n    if (!context.request.store || context.request.cacheOptions?.[SkipCache]) {\n      return next(context.request);\n    }\n\n    const { store } = context.request;\n    const identifier = store.identifierCache.getOrCreateDocumentIdentifier(context.request);\n    const peeked = identifier ? store.cache.peekRequest(identifier) : null;\n\n    // In a Worker, any time we are asked to make a request, data needs to be returned.\n    // background requests are ergo no different than foreground requests.\n    if (calcShouldFetch(store, context.request, !!peeked, identifier)) {\n      return fetchContentAndHydrate(next, context, identifier);\n    }\n\n    assert(`Expected a peeked request to be present`, peeked);\n    context.setResponse(peeked.response);\n\n    if ('error' in peeked) {\n      throw peeked;\n    }\n\n    return maybeUpdateObjects<T>(store, peeked.content as ResourceDataDocument);\n  },\n};\n\nfunction maybeUpdateObjects<T>(store: Store, document: ResourceDataDocument | null): T {\n  if (!document) {\n    return document as T;\n  }\n\n  if (Array.isArray(document.data)) {\n    const data = document.data.map((identifier) => {\n      return store.cache.peek(identifier);\n    });\n\n    return Object.assign({}, document, { data }) as T;\n  } else {\n    const data = (document.data ? store.cache.peek(document.data) : null) as T;\n    return Object.assign({}, document, { data }) as T;\n  }\n}\n\nfunction updateCacheForSuccess<T>(\n  store: Store,\n  request: StoreRequestContext['request'],\n  document: StructuredDataDocument<T>\n) {\n  let response: ResourceDataDocument | null = null;\n  if (isMutation(request)) {\n    const record = request.data?.record || request.records?.[0];\n    if (record) {\n      response = store.cache.didCommit(record, document) as ResourceDataDocument;\n\n      // a mutation combined with a 204 has no cache impact when no known records were involved\n      // a createRecord with a 201 with an empty response and no known records should similarly\n      // have no cache impact\n    } else if (isCacheAffecting(document)) {\n      response = store.cache.put(document) as ResourceDataDocument;\n    }\n  } else {\n    response = store.cache.put(document) as ResourceDataDocument;\n  }\n  return maybeUpdateObjects(store, response);\n}\n\nfunction handleFetchSuccess<T>(\n  store: Store,\n  request: StoreRequestContext['request'],\n  identifier: StableDocumentIdentifier | null,\n  document: StructuredDataDocument<T>\n): T {\n  let response: ResourceDataDocument;\n  store._join(() => {\n    response = updateCacheForSuccess<T>(store, request, document) as ResourceDataDocument;\n  });\n\n  if (store.lifetimes?.didRequest) {\n    store.lifetimes.didRequest(request, document.response, identifier, store);\n  }\n\n  return response! as T;\n}\n\nfunction updateCacheForError<T>(\n  store: Store,\n  request: StoreRequestContext['request'],\n  error: StructuredErrorDocument<T>\n) {\n  if (isMutation(request)) {\n    // TODO similar to didCommit we should spec this to be similar to cache.put for handling full response\n    // currently we let the response remain undefiend.\n    const errors =\n      error &&\n      error.content &&\n      typeof error.content === 'object' &&\n      'errors' in error.content &&\n      Array.isArray(error.content.errors)\n        ? (error.content.errors as ApiError[])\n        : undefined;\n\n    const record = request.data?.record || request.records?.[0];\n\n    store.cache.commitWasRejected(record, errors);\n  } else {\n    return store.cache.put(error) as ResourceErrorDocument;\n  }\n}\n\nfunction handleFetchError<T>(\n  store: Store,\n  request: StoreRequestContext['request'],\n  identifier: StableDocumentIdentifier | null,\n  error: StructuredErrorDocument<T>\n): never {\n  if (request.signal?.aborted) {\n    throw error;\n  }\n  let response: ResourceErrorDocument | undefined;\n  store._join(() => {\n    response = updateCacheForError(store, request, error);\n  });\n\n  if (identifier && store.lifetimes?.didRequest) {\n    store.lifetimes.didRequest(request, error.response, identifier, store);\n  }\n\n  if (isMutation(request)) {\n    throw error;\n  }\n\n  const newError = cloneError(error);\n  newError.content = response!;\n  throw newError;\n}\n\nfunction fetchContentAndHydrate<T>(\n  next: NextFn<T>,\n  context: StoreRequestContext,\n  identifier: StableDocumentIdentifier | null\n): Promise<T> {\n  const { request } = context;\n  const { store } = context.request;\n\n  if (isMutation(request)) {\n    // TODO should we handle multiple records in request.records by iteratively calling willCommit for each\n    const record = request.data?.record || request.records?.[0];\n    assert(`Expected to receive a list of records included in the ${request.op} request`, record);\n    if (record) {\n      store.cache.willCommit(record, context);\n    }\n  }\n\n  if (store.lifetimes?.willRequest) {\n    store.lifetimes.willRequest(request, identifier, store);\n  }\n\n  return next(request).then(\n    (document) => handleFetchSuccess(store, request, identifier, document),\n    (error: StructuredErrorDocument<T>) => handleFetchError(store, request, identifier, error)\n  );\n}\n"],"names":["DataWorker","constructor","UserStore","store","threads","Map","pending","initialize","globalThis","onmessage","event","type","data","setupThread","thread","ports","port","set","delete","abortRequest","request","id","future","get","abort","result","postMessage","prepareResponse","error","isAbortError","softCloneResponse","response","clone","headers","key","value","entries","ok","redirected","status","statusText","url","Error","name","newResponse","content","MUTATION_OPS","Set","calcShouldFetch","hasCachedValue","identifier","cacheOptions","op","has","reload","backgroundReload","lifetimes","isHardExpired","isSoftExpired","isMutation","Boolean","isCacheAffecting","document","Object","keys","length","isAggregateError","AggregateError","Array","isArray","errors","cloneError","isAggregate","cloned","structuredClone","message","stack","assign","CacheHandler","context","next","SkipCache","identifierCache","getOrCreateDocumentIdentifier","peeked","cache","peekRequest","fetchContentAndHydrate","macroCondition","getGlobalConfig","WarpDrive","env","DEBUG","test","setResponse","maybeUpdateObjects","map","peek","updateCacheForSuccess","record","records","didCommit","put","handleFetchSuccess","_join","didRequest","updateCacheForError","undefined","commitWasRejected","handleFetchError","signal","aborted","newError","willCommit","willRequest","then"],"mappings":"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"}

package/dist/document-storage.js

@@ -0,0 +1,243 @@
+const WARP_DRIVE_STORAGE_FILE_NAME = 'warp-drive_document-storage';
+const WARP_DRIVE_STORAGE_VERSION = 1;
+
+/**
+ * DocumentStorage is specifically designed around WarpDrive Cache and Request concepts.
+ *
+ * CacheFileDocument is a StructuredDocument (request response) whose `content` is
+ * the ResourceDocument returned by inserting the request into a Store's Cache.
+ */
+
+/**
+ * A CacheDocument is a reconstructed request response that rehydrates ResourceDocument
+ * with the associated resources based on their identifiers.
+ */
+
+class InternalDocumentStorage {
+  constructor(options) {
+    this.options = options;
+    this._lastModified = 0;
+    this._invalidated = true;
+    this._fileHandle = this._open(options.scope);
+    this._channel = Object.assign(new BroadcastChannel(options.scope), {
+      onmessage: this._onMessage.bind(this)
+    });
+  }
+  _onMessage(_event) {
+    this._invalidated = true;
+  }
+  async _open(scope) {
+    const directoryHandle = await navigator.storage.getDirectory();
+    const fileHandle = await directoryHandle.getFileHandle(scope, {
+      create: true
+    });
+    return fileHandle;
+  }
+  async _read() {
+    if (this._filePromise) {
+      return this._filePromise;
+    }
+    if (this._invalidated) {
+      const updateFile = async () => {
+        const fileHandle = await this._fileHandle;
+        const file = await fileHandle.getFile();
+        const lastModified = file.lastModified;
+        if (lastModified === this._lastModified && this._cache) {
+          return this._cache;
+        }
+        const contents = await file.text();
+        const cache = contents ? JSON.parse(contents) : {
+          documents: [],
+          resources: []
+        };
+        const documents = new Map(cache.documents);
+        const resources = new Map(cache.resources);
+        const cacheMap = {
+          documents,
+          resources
+        };
+        this._cache = cacheMap;
+        this._invalidated = false;
+        this._lastModified = lastModified;
+        return cacheMap;
+      };
+      this._filePromise = updateFile();
+      await this._filePromise;
+      this._filePromise = null;
+    }
+    return this._cache;
+  }
+  async _patch(documentKey, document, updatedResources) {
+    const fileHandle = await this._fileHandle;
+    // secure a lock before getting latest state
+    const writable = await fileHandle.createWritable();
+    const cache = await this._read();
+    cache.documents.set(documentKey, document);
+    updatedResources.forEach((resource, key) => {
+      cache.resources.set(key, resource);
+    });
+    const documents = [...cache.documents.entries()];
+    const resources = [...cache.resources.entries()];
+    const cacheFile = {
+      documents,
+      resources
+    };
+    await writable.write(JSON.stringify(cacheFile));
+    await writable.close();
+    this._channel.postMessage({
+      type: 'patch',
+      key: documentKey,
+      resources: [...updatedResources.keys()]
+    });
+  }
+  async getDocument(key) {
+    const cache = await this._read();
+    // clone the document to avoid leaking the internal cache
+    const document = structuredClone(cache.documents.get(key.lid));
+    if (!document) {
+      return null;
+    }
+
+    // expand the document with the resources
+    if (document.content) {
+      if (docHasData(document.content)) {
+        let data = null;
+        if (Array.isArray(document.content.data)) {
+          data = document.content.data.map(resourceIdentifier => {
+            const resource = cache.resources.get(resourceIdentifier.lid);
+            if (!resource) {
+              throw new Error(`Resource not found for ${resourceIdentifier.lid}`);
+            }
+
+            // clone the resource to avoid leaking the internal cache
+            return structuredClone(resource);
+          });
+        } else if (document.content.data) {
+          const resource = cache.resources.get(document.content.data.lid);
+          if (!resource) {
+            throw new Error(`Resource not found for ${document.content.data.lid}`);
+          }
+
+          // clone the resource to avoid leaking the internal cache
+          data = structuredClone(resource);
+        }
+        if (document.content.included) {
+          const included = document.content.included.map(resourceIdentifier => {
+            const resource = cache.resources.get(resourceIdentifier.lid);
+            if (!resource) {
+              throw new Error(`Resource not found for ${resourceIdentifier.lid}`);
+            }
+
+            // clone the resource to avoid leaking the internal cache
+            return structuredClone(resource);
+          });
+          document.content.included = included;
+        }
+        document.content.data = data;
+      }
+    }
+    return document;
+  }
+  async putDocument(document, resourceCollector) {
+    const resources = new Map();
+    if (!document.content) {
+      throw new Error(`Document content is missing, only finalized documents can be stored`);
+    }
+    if (!document.content.lid) {
+      throw new Error(`Document content is missing a lid, only documents with a cache-key can be stored`);
+    }
+    if (docHasData(document.content)) {
+      if (Array.isArray(document.content.data)) {
+        document.content.data.forEach(resourceIdentifier => {
+          const resource = resourceCollector(resourceIdentifier);
+          resources.set(resourceIdentifier.lid, structuredClone(resource));
+        });
+      } else if (document.content.data) {
+        const resource = resourceCollector(document.content.data);
+        resources.set(document.content.data.lid, structuredClone(resource));
+      }
+      if (document.content.included) {
+        document.content.included.forEach(resourceIdentifier => {
+          const resource = resourceCollector(resourceIdentifier);
+          resources.set(resourceIdentifier.lid, structuredClone(resource));
+        });
+      }
+    }
+    await this._patch(document.content.lid, structuredClone(document), resources);
+  }
+  async clear(reset) {
+    const fileHandle = await this._fileHandle;
+    const writable = await fileHandle.createWritable();
+    await writable.write('');
+    await writable.close();
+    this._invalidated = true;
+    this._lastModified = 0;
+    this._cache = null;
+    this._filePromise = null;
+    this._channel.postMessage({
+      type: 'clear'
+    });
+    if (!reset) {
+      this._channel.close();
+      this._channel = null;
+      if (!this.options.isolated) {
+        Storages.delete(this.options.scope);
+      }
+    }
+  }
+}
+function docHasData(doc) {
+  return 'data' in doc;
+}
+const Storages = new Map();
+
+/**
+ * DocumentStorage is a wrapper around the StorageManager API that provides
+ * a simple interface for reading and updating documents and requests.
+ *
+ * Some goals for this experiment:
+ *
+ * - optimize for storing requests/documents
+ * - optimize for storing resources
+ * - optimize for looking up resources associated to a document
+ * - optimize for notifying cross-tab when data is updated
+ *
+ * optional features:
+ *
+ * - support for offline mode
+ * - ?? support for relationship based cache traversal
+ * - a way to index records by type + another field (e.g updatedAt/createAt/name)
+ *   such that simple queries can be done without having to scan all records
+ */
+class DocumentStorage {
+  constructor(options = {}) {
+    options.isolated = options.isolated ?? false;
+    options.scope = options.scope ?? 'default';
+    const fileName = `${WARP_DRIVE_STORAGE_FILE_NAME}@version_${WARP_DRIVE_STORAGE_VERSION}:${options.scope}`;
+    if (!options.isolated && Storages.has(fileName)) {
+      const storage = Storages.get(fileName);
+      if (storage) {
+        this._storage = storage.deref();
+        return;
+      }
+    }
+    const storage = new InternalDocumentStorage({
+      scope: fileName,
+      isolated: options.isolated
+    });
+    this._storage = storage;
+    if (!options.isolated) {
+      Storages.set(fileName, new WeakRef(storage));
+    }
+  }
+  getDocument(key) {
+    return this._storage.getDocument(key);
+  }
+  putDocument(document, resourceCollector) {
+    return this._storage.putDocument(document, resourceCollector);
+  }
+  clear(reset) {
+    return this._storage.clear(reset);
+  }
+}
+export { DocumentStorage };