{"_id":"@cloudflare/kv-asset-handler","_rev":"2951182","name":"@cloudflare/kv-asset-handler","description":"Routes requests to KV assets","dist-tags":{"latest":"0.3.0"},"maintainers":[{"name":"wrangler-publisher","email":""}],"time":{"modified":"2023-04-27T03:32:00.000Z","created":"2019-09-19T23:45:00.594Z","0.3.0":"2022-12-19T20:18:00.375Z","0.2.0":"2021-11-16T13:02:31.519Z","0.1.3":"2021-06-18T12:13:20.951Z","0.1.2":"2021-05-24T17:09:20.111Z","0.1.1":"2021-03-15T17:31:35.139Z","0.1.0":"2020-12-02T16:28:09.322Z","0.0.12":"2020-09-02T18:27:47.883Z","0.0.11":"2020-06-30T16:10:09.605Z","0.0.10":"2020-04-28T15:51:03.724Z","0.0.9":"2020-02-20T23:01:38.098Z","0.0.8":"2020-02-14T19:38:15.434Z","0.0.7":"2019-11-01T22:37:33.204Z","0.0.6":"2019-10-29T22:00:18.012Z","0.0.5":"2019-09-26T20:33:23.131Z","0.0.4":"2019-09-26T16:30:18.385Z","0.0.2":"2019-09-20T23:34:55.981Z","0.0.1":"2019-09-19T23:45:00.594Z"},"users":{},"author":{"name":"wrangler@cloudflare.com"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/kv-asset-handler.git"},"versions":{"0.3.0":{"name":"@cloudflare/kv-asset-handler","version":"0.3.0","description":"Routes requests to KV assets","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"prepack":"npm run build","build":"tsc -d","format":"prettier --write \"**/*.{js,ts,json,md}\"","pretest":"npm run build","lint:code":"prettier --check \"**/*.{js,ts,json,md}\"","lint:markdown":"markdownlint \"**/*.md\" --ignore node_modules","test":"ava dist/test/*.js --verbose"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/kv-asset-handler.git"},"keywords":["kv","cloudflare","workers","wrangler","assets"],"author":{"name":"wrangler@cloudflare.com"},"license":"MIT OR Apache-2.0","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","dependencies":{"mime":"^3.0.0"},"devDependencies":{"@ava/typescript":"^3.0.1","@cloudflare/workers-types":"^4.20221111.1","@types/mime":"^3.0.1","@types/node":"^18.11.12","ava":"^5.1.0","prettier":"^2.8.1","service-worker-mock":"^2.0.5","typescript":"^4.9.4"},"gitHead":"e50a336b1a3f0d59c909a4943335fab217a6bc61","_id":"@cloudflare/kv-asset-handler@0.3.0","_nodeVersion":"18.0.0","_npmVersion":"8.6.0","dist":{"shasum":"11f0af0749a400ddadcca16dcd6f4696d7036991","size":25347,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.3.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.3.0.tgz"},"_npmUser":{"name":"caass","email":"cass@swag.lgbt"},"directories":{},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.3.0_1671481080231_0.9543948780566187"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2022-12-19T20:43:46.209Z","publish_time":1671481080375,"_cnpm_publish_time":1671481080375},"0.2.0":{"name":"@cloudflare/kv-asset-handler","version":"0.2.0","description":"Routes requests to KV assets","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"prepack":"npm run build","build":"tsc -d","format":"prettier --write \"**/*.{js,ts,json,md}\"","pretest":"npm run build","lint:code":"prettier --check \"**/*.{js,ts,json,md}\"","lint:markdown":"markdownlint \"**/*.md\" --ignore node_modules","test":"ava dist/test/*.js --verbose"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/kv-asset-handler.git"},"keywords":["kv","cloudflare","workers","wrangler","assets"],"author":{"name":"wrangler@cloudflare.com"},"license":"MIT OR Apache-2.0","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","dependencies":{"mime":"^3.0.0"},"devDependencies":{"@ava/typescript":"^3.0.0","@cloudflare/workers-types":"^3.0.0","@types/mime":"^2.0.3","@types/node":"^15.14.9","ava":"^3.15.0","prettier":"^2.4.1","service-worker-mock":"^2.0.5","typescript":"^4.4.4"},"gitHead":"ff8d3dc30c7f4acc820bdde3306af7c8ebc469ec","_id":"@cloudflare/kv-asset-handler@0.2.0","_nodeVersion":"16.7.0","_npmVersion":"7.20.3","dist":{"shasum":"c9959bbd7a1c40bd7c674adae98aa8c8d0e5ca68","size":24872,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.2.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.2.0.tgz"},"_npmUser":{"name":"threepointone","email":"threepointone@gmail.com"},"directories":{},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.2.0_1637067751353_0.7134395545707115"},"_hasShrinkwrap":false,"publish_time":1637067751519,"_cnpm_publish_time":1637067751519,"_cnpmcore_publish_time":"2021-12-16T23:26:04.591Z"},"0.1.3":{"name":"@cloudflare/kv-asset-handler","version":"0.1.3","description":"Routes requests to KV assets","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"prepack":"npm run build","build":"tsc -d","format":"prettier --write \"**/*.{js,ts,json,md}\"","pretest":"npm run build","lint:code":"prettier --check \"**/*.{js,ts,json,md}\"","lint:markdown":"markdownlint \"**/*.md\" --ignore node_modules","test":"ava dist/test/*.js --verbose"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/kv-asset-handler.git"},"keywords":["kv","cloudflare","workers","wrangler","assets"],"author":{"name":"wrangler@cloudflare.com"},"license":"MIT OR Apache-2.0","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","dependencies":{"mime":"^2.5.2"},"devDependencies":{"@ava/typescript":"^1.1.1","@cloudflare/workers-types":"^2.2.2","@types/mime":"^2.0.3","@types/node":"^15.3.0","ava":"^3.15.0","prettier":"^2.3.0","service-worker-mock":"^2.0.5","typescript":"^4.2.4"},"gitHead":"26df92609b37c650f59f3ecf172e9bef2ddb8588","_id":"@cloudflare/kv-asset-handler@0.1.3","_nodeVersion":"16.3.0","_npmVersion":"7.15.1","dist":{"shasum":"3eaaf962b16c48a7189db5d5ac1c4dca4e2ed1a0","size":24752,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.1.3.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.1.3.tgz"},"_npmUser":{"name":"nataliescottdavidson","email":"davidsonnatalies@gmail.com"},"directories":{},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.1.3_1624018400853_0.1764899219533258"},"_hasShrinkwrap":false,"publish_time":1624018400951,"_cnpm_publish_time":1624018400951,"_cnpmcore_publish_time":"2021-12-16T23:26:05.110Z"},"0.1.2":{"name":"@cloudflare/kv-asset-handler","version":"0.1.2","description":"Routes requests to KV assets","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"prepack":"npm run build","build":"tsc -d","format":"prettier --write \"**/*.{js,ts,json,md}\"","pretest":"npm run build","lint:code":"prettier --check \"**/*.{js,ts,json,md}\"","lint:markdown":"markdownlint \"**/*.md\" --ignore node_modules","test":"ava dist/test/*.js --verbose"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/kv-asset-handler.git"},"keywords":["kv","cloudflare","workers","wrangler","assets"],"author":{"name":"wrangler@cloudflare.com"},"license":"MIT OR Apache-2.0","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","dependencies":{"mime":"^2.5.2"},"devDependencies":{"@ava/typescript":"^1.1.1","@cloudflare/workers-types":"^2.2.2","@types/mime":"^2.0.3","@types/node":"^15.3.0","ava":"^3.15.0","prettier":"^2.3.0","service-worker-mock":"^2.0.5","typescript":"^4.2.4"},"gitHead":"7b2970047681e6665ae20752b8de0d1e138994c7","_id":"@cloudflare/kv-asset-handler@0.1.2","_nodeVersion":"14.15.3","_npmVersion":"6.14.9","dist":{"shasum":"8c0b82a0d92e6eb362c9594f74f824e162724a93","size":28760,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.1.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.1.2.tgz"},"_npmUser":{"name":"caass","email":"cass@swag.lgbt"},"directories":{},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.1.2_1621876159994_0.08384778214119315"},"_hasShrinkwrap":false,"publish_time":1621876160111,"_cnpm_publish_time":1621876160111,"_cnpmcore_publish_time":"2021-12-16T23:26:05.433Z"},"0.1.1":{"name":"@cloudflare/kv-asset-handler","version":"0.1.1","description":"Routes requests to KV assets","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"prepack":"npm run build","build":"tsc -d","format":"prettier --write '**/*.js'","pretest":"npm run build","test":"ava dist/test/*.js --verbose"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/workers-site-npm-pkg.git"},"keywords":["kv","cloudflare","workers","wrangler","assets"],"author":{"name":"wrangler@cloudflare.com"},"license":"MIT OR Apache-2.0","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","dependencies":{"@cloudflare/workers-types":"^2.0.0","@types/mime":"^2.0.2","mime":"^2.4.6"},"devDependencies":{"ava":"^3.9.0","service-worker-mock":"^2.0.5","typescript":"^3.9.5"},"gitHead":"6cd7cc9a5b3c03a01e68d40385969766489ecdc7","_id":"@cloudflare/kv-asset-handler@0.1.1","_nodeVersion":"14.15.3","_npmVersion":"6.14.9","dist":{"shasum":"7ed87e0d20ce57115251a8ffc5b6b494715f6eda","size":31623,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.1.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.1.1.tgz"},"_npmUser":{"name":"caass","email":"cass@swag.lgbt"},"directories":{},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.1.1_1615829494995_0.17733557285990176"},"_hasShrinkwrap":false,"publish_time":1615829495139,"_cnpm_publish_time":1615829495139,"_cnpmcore_publish_time":"2021-12-16T23:26:05.719Z"},"0.1.0":{"name":"@cloudflare/kv-asset-handler","version":"0.1.0","description":"Routes requests to KV assets","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"prepack":"npm run build","build":"tsc -d","format":"prettier --write '**/*.js'","pretest":"npm run build","test":"ava dist/test/*.js --verbose"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/workers-site-npm-pkg.git"},"keywords":["kv","cloudflare","workers","wrangler","assets"],"author":{"name":"wrangler@cloudflare.com"},"license":"MIT OR Apache-2.0","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","dependencies":{"@cloudflare/workers-types":"^2.0.0","@types/mime":"^2.0.2","mime":"^2.4.6"},"devDependencies":{"ava":"^3.9.0","service-worker-mock":"^2.0.5","typescript":"^3.9.5"},"gitHead":"c261555b35ad363a795f7f139deff06380c78a79","_id":"@cloudflare/kv-asset-handler@0.1.0","_nodeVersion":"12.2.0","_npmVersion":"6.9.0","dist":{"shasum":"0febbf4ac6dd04d2c069405cffdcc7cf64b95494","size":30620,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.1.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.1.0.tgz"},"_npmUser":{"name":"xtuc","email":"npm@sauleau.com"},"directories":{},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.1.0_1606926489106_0.4054938124200309"},"_hasShrinkwrap":false,"publish_time":1606926489322,"_cnpm_publish_time":1606926489322,"_cnpmcore_publish_time":"2021-12-16T23:26:05.995Z"},"0.0.12":{"name":"@cloudflare/kv-asset-handler","version":"0.0.12","description":"Routes requests to KV assets","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"prepack":"npm run build","build":"tsc -d","format":"prettier --write '**/*.js'","pretest":"npm run build","test":"ava dist/test/*.js --verbose"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/workers-site-npm-pkg.git"},"keywords":["kv","cloudflare","workers","wrangler","assets"],"author":{"name":"wrangler@cloudflare.com"},"license":"MIT OR Apache-2.0","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","dependencies":{"@cloudflare/workers-types":"^2.0.0","@types/mime":"^2.0.2","mime":"^2.4.6"},"devDependencies":{"ava":"^3.9.0","service-worker-mock":"^2.0.5","typescript":"^3.9.5"},"gitHead":"76fc3b5a17c9cc2b18bd6dc009e32fa60b3fb2c3","_id":"@cloudflare/kv-asset-handler@0.0.12","_nodeVersion":"12.16.3","_npmVersion":"6.14.4","dist":{"shasum":"4fc397912a0897a5cf8c0b5eb7c983b5e8b36979","size":30658,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.0.12.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.0.12.tgz"},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmUser":{"name":"imkmf","email":"kristian@kristianfreeman.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.0.12_1599071267769_0.19267816906933777"},"_hasShrinkwrap":false,"publish_time":1599071267883,"_cnpm_publish_time":1599071267883,"_cnpmcore_publish_time":"2021-12-16T23:26:06.277Z"},"0.0.11":{"name":"@cloudflare/kv-asset-handler","version":"0.0.11","description":"Routes requests to KV assets","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"prepack":"npm run build","build":"tsc -d","format":"prettier --write '**/*.js'","pretest":"npm run build","test":"ava dist/test/*.js --verbose"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/workers-site-npm-pkg.git"},"keywords":["kv","cloudflare","workers","wrangler","assets"],"author":{"name":"wrangler@cloudflare.com"},"license":"MIT OR Apache-2.0","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","dependencies":{"@cloudflare/workers-types":"^2.0.0","@types/mime":"^2.0.2","mime":"^2.4.6"},"devDependencies":{"ava":"^3.9.0","service-worker-mock":"^2.0.5","typescript":"^3.9.5"},"gitHead":"902bf1756a554965dda8bf6d95f1229e2b21b2c1","_id":"@cloudflare/kv-asset-handler@0.0.11","_nodeVersion":"14.4.0","_npmVersion":"6.14.5","dist":{"shasum":"3f0200717c76d326122bd59b06074df27f9e3f4f","size":29888,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.0.11.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.0.11.tgz"},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmUser":{"name":"averyharnish","email":"averyharnish@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.0.11_1593533409279_0.831353301293833"},"_hasShrinkwrap":false,"publish_time":1593533409605,"_cnpm_publish_time":1593533409605,"_cnpmcore_publish_time":"2021-12-16T23:26:06.487Z"},"0.0.10":{"name":"@cloudflare/kv-asset-handler","version":"0.0.10","description":"Routes requests to KV assets","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"prepack":"npm run build","build":"tsc -d","format":"prettier --write '**/*.js'","pretest":"npm run build","test":"ava dist/test/*.js --verbose"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/workers-site-npm-pkg.git"},"keywords":["kv","cloudflare","workers","wrangler","assets"],"author":{"name":"wrangler@cloudflare.com"},"license":"MIT OR Apache-2.0","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","dependencies":{"@types/mime":"^2.0.1","mime":"^2.4.4"},"ava":{"require":["esm"]},"devDependencies":{"@cloudflare/workers-types":"^1.0.1","ava":"^1.4.1","service-worker-mock":"^2.0.3","ts-loader":"^6.2.1","typescript":"^3.7.2"},"gitHead":"51243ef6c822608b615e992859383cd72631d2cd","_id":"@cloudflare/kv-asset-handler@0.0.10","_nodeVersion":"13.8.0","_npmVersion":"6.13.6","dist":{"shasum":"36110e02394a8389db4d2d0c77649587edc537bf","size":45793,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.0.10.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.0.10.tgz"},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmUser":{"name":"victoriabernard92","email":"bernard.victoria22@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.0.10_1588089063559_0.6764415658745342"},"_hasShrinkwrap":false,"publish_time":1588089063724,"_cnpm_publish_time":1588089063724,"_cnpmcore_publish_time":"2021-12-16T23:26:06.796Z"},"0.0.9":{"name":"@cloudflare/kv-asset-handler","version":"0.0.9","description":"Routes requests to KV assets","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"prepack":"npm run build","build":"tsc -d","format":"prettier --write '**/*.js'","pretest":"npm run build","test":"ava dist/test/*.js --verbose"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/workers-site-npm-pkg.git"},"keywords":["kv","cloudflare","workers","wrangler","assets"],"author":{"name":"Avery Harnish"},"license":"MIT","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","dependencies":{"@types/mime":"^2.0.1","mime":"^2.4.4"},"ava":{"require":["esm"]},"devDependencies":{"@cloudflare/workers-types":"^1.0.1","ava":"^1.4.1","service-worker-mock":"^2.0.3","ts-loader":"^6.2.1","typescript":"^3.7.2"},"gitHead":"9c76606b9c1b1cf51717585944484d9a98784b4e","_id":"@cloudflare/kv-asset-handler@0.0.9","_nodeVersion":"10.17.0","_npmVersion":"6.13.7","dist":{"shasum":"b49247eb49819080ed0db796992e6e5dd7cd81ce","size":19970,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.0.9.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.0.9.tgz"},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmUser":{"name":"ag_dubs","email":"ashley666ashley@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.0.9_1582239697976_0.4966041367043057"},"_hasShrinkwrap":false,"publish_time":1582239698098,"_cnpm_publish_time":1582239698098,"_cnpmcore_publish_time":"2021-12-16T23:26:07.028Z"},"0.0.8":{"name":"@cloudflare/kv-asset-handler","version":"0.0.8","description":"Routes requests to KV assets","main":"./dist/index.js","types":"./dist/index.d.ts","scripts":{"build":"tsc -d","format":"prettier --write '**/*.js'","test":"ava dist/test/*.js --verbose"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/workers-site-npm-pkg.git"},"keywords":["kv","cloudflare","workers","wrangler","assets"],"author":{"name":"Avery Harnish"},"license":"MIT","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","dependencies":{"@types/mime":"^2.0.1","mime":"^2.4.4"},"ava":{"require":["esm"]},"devDependencies":{"@cloudflare/workers-types":"^1.0.1","ava":"^1.4.1","service-worker-mock":"^2.0.3","ts-loader":"^6.2.1","typescript":"^3.7.2"},"gitHead":"3c20fb5a46203496877b8e2de61de018af944e25","_id":"@cloudflare/kv-asset-handler@0.0.8","_nodeVersion":"10.17.0","_npmVersion":"6.13.7","dist":{"shasum":"1681ef4cbf4e2de272f5bf184eb2832a0b2790ff","size":13286,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.0.8.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.0.8.tgz"},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmUser":{"name":"ag_dubs","email":"ashley666ashley@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.0.8_1581709095312_0.702934400147055"},"_hasShrinkwrap":false,"publish_time":1581709095434,"_cnpm_publish_time":1581709095434,"_cnpmcore_publish_time":"2021-12-16T23:26:07.520Z"},"0.0.7":{"name":"@cloudflare/kv-asset-handler","version":"0.0.7","description":"Routes requests to KV assets","main":"./src/index.js","scripts":{"build":"webpack","format":"prettier --write '**/*.js'","test":"ava test/*.js --verbose","test:watch":"npm run test -w"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/workers-site-npm-pkg.git"},"keywords":["kv","cloudflare","cloudflare","workers","wrangler","assets"],"author":{"name":"Avery Harnish"},"license":"MIT","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","dependencies":{"mime":"^2.4.4"},"ava":{"require":["esm"]},"devDependencies":{"@cloudflare/workers-types":"^1.0.1","ava":"^1.4.1","service-worker-mock":"^2.0.3","prettier":"^1.18.2"},"gitHead":"15491549be7d96cf3873c2d3534862904e554021","_id":"@cloudflare/kv-asset-handler@0.0.7","_nodeVersion":"10.16.0","_npmVersion":"6.12.1","dist":{"shasum":"d8660076193f9e9018b7bc659ffc262f2ed8bbd2","size":11560,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.0.7.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.0.7.tgz"},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmUser":{"name":"ag_dubs","email":"ashley666ashley@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.0.7_1572647853085_0.3204529624289383"},"_hasShrinkwrap":false,"publish_time":1572647853204,"_cnpm_publish_time":1572647853204,"_cnpmcore_publish_time":"2021-12-16T23:26:07.777Z"},"0.0.6":{"name":"@cloudflare/kv-asset-handler","version":"0.0.6","description":"Routes requests to KV assets","main":"./src/index.js","scripts":{"build":"webpack","format":"prettier --write '**/*.js'","test":"ava test/*.js --verbose","test:watch":"npm run test -w"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/workers-site-npm-pkg.git"},"keywords":["kv","cloudflare","cloudflare","workers","wrangler","assets"],"author":{"name":"Avery Harnish"},"license":"MIT","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","dependencies":{"mime":"^2.4.4"},"ava":{"require":["esm"]},"devDependencies":{"@cloudflare/workers-types":"^1.0.1","ava":"^1.4.1","service-worker-mock":"^2.0.3","prettier":"^1.18.2"},"gitHead":"023217075bc60f8d55ff244435a97c8edd9ffc0b","_id":"@cloudflare/kv-asset-handler@0.0.6","_nodeVersion":"10.16.0","_npmVersion":"6.10.1","dist":{"shasum":"13040cbcf3b4727676dbda5a58d469a5ee5060bf","size":9327,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.0.6.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.0.6.tgz"},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmUser":{"name":"ag_dubs","email":"ashley666ashley@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.0.6_1572386417871_0.038216836406034016"},"_hasShrinkwrap":false,"publish_time":1572386418012,"_cnpm_publish_time":1572386418012,"_cnpmcore_publish_time":"2021-12-16T23:26:07.982Z"},"0.0.5":{"name":"@cloudflare/kv-asset-handler","version":"0.0.5","description":"Routes requests to KV assets","main":"./src/index.js","scripts":{"build":"webpack","format":"prettier --write '**/*.js'","test":"ava test/*.js --verbose","test:watch":"npm run test -w"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/workers-site-npm-pkg.git"},"keywords":["kv","cloudflare","cloudflare","workers","wrangler","assets"],"author":{"name":"Avery Harnish"},"license":"MIT","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","dependencies":{"mime":"^2.4.4"},"ava":{"require":["esm"]},"devDependencies":{"@cloudflare/workers-types":"^1.0.1","ava":"^1.4.1","service-worker-mock":"^2.0.3","prettier":"^1.18.2"},"gitHead":"40ec383119527c2c2b3635a7e70dfc07cb576e3c","_id":"@cloudflare/kv-asset-handler@0.0.5","_nodeVersion":"12.9.0","_npmVersion":"6.11.3","dist":{"shasum":"7719c9f2cbe9516e0e3839bb0dc228dd3e399d74","size":8867,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.0.5.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.0.5.tgz"},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmUser":{"name":"ag_dubs","email":"ashley666ashley@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.0.5_1569530002995_0.36459145901155066"},"_hasShrinkwrap":false,"publish_time":1569530003131,"_cnpm_publish_time":1569530003131,"_cnpmcore_publish_time":"2021-12-16T23:26:08.205Z"},"0.0.4":{"name":"@cloudflare/kv-asset-handler","version":"0.0.4","description":"Routes requests to KV assets","main":"./src/index.js","scripts":{"build":"webpack","format":"prettier --write '**/*.js'","test":"ava test/*.js --verbose","test:watch":"npm run test -w"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/workers-site-npm-pkg.git"},"keywords":["kv","cloudflare","cloudflare","workers","wrangler","assets"],"author":{"name":"Avery Harnish"},"license":"MIT","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","dependencies":{"mime":"^2.4.4"},"ava":{"require":["esm"]},"devDependencies":{"@cloudflare/workers-types":"^1.0.1","ava":"^1.4.1","service-worker-mock":"^2.0.3","prettier":"^1.18.2"},"gitHead":"af49446b390aedecbb6f6bf7de189e3da2fd6307","_id":"@cloudflare/kv-asset-handler@0.0.4","_nodeVersion":"12.9.0","_npmVersion":"6.11.3","dist":{"shasum":"a41e04ede93eca2ea89b2a7779e90a9d973f51eb","size":8836,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.0.4.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.0.4.tgz"},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmUser":{"name":"ag_dubs","email":"ashley666ashley@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.0.4_1569515418256_0.06367562092528978"},"_hasShrinkwrap":false,"publish_time":1569515418385,"_cnpm_publish_time":1569515418385,"_cnpmcore_publish_time":"2021-12-16T23:26:08.420Z"},"0.0.2":{"name":"@cloudflare/kv-asset-handler","version":"0.0.2","description":"Routes requests to KV assets","main":"./src/index.js","scripts":{"build":"webpack","format":"prettier --write '**/*.js'","test":"ava test/*.js --verbose","test:watch":"npm run test -w"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/workers-site-npm-pkg.git"},"keywords":["kv","cloudflare","cloudflare","workers","wrangler","assets"],"author":{"name":"Avery Harnish"},"license":"MIT","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","dependencies":{"mime":"^2.4.4"},"ava":{"require":["esm"]},"devDependencies":{"@cloudflare/workers-types":"^1.0.1","ava":"^1.4.1","service-worker-mock":"^2.0.3","prettier":"^1.18.2"},"gitHead":"aeadd61b1aad75fe9ec1a1dff31b543e93508f6a","_id":"@cloudflare/kv-asset-handler@0.0.2","_nodeVersion":"10.16.0","_npmVersion":"6.10.1","dist":{"shasum":"6385d2d7e621015ff7f1c0d89e24dfd843ecfff4","size":7430,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.0.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.0.2.tgz"},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmUser":{"name":"ag_dubs","email":"ashley666ashley@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.0.2_1569022495830_0.1255681955884409"},"_hasShrinkwrap":false,"publish_time":1569022495981,"_cnpm_publish_time":1569022495981,"_cnpmcore_publish_time":"2021-12-16T23:26:08.637Z"},"0.0.1":{"name":"@cloudflare/kv-asset-handler","version":"0.0.1","description":"Routes requests to KV assets","main":"./src/index.js","scripts":{"build":"webpack","format":"prettier --write '**/*.js'","test":"ava test/*.js --verbose","test:watch":"npm run test -w"},"repository":{"type":"git","url":"git+https://github.com/cloudflare/workers-site-npm-pkg.git"},"keywords":["kv","cloudflare","cloudflare","workers","wrangler","assets"],"author":{"name":"Avery Harnish"},"license":"MIT","bugs":{"url":"https://github.com/cloudflare/workers-site-npm-pkg/issues"},"homepage":"https://github.com/cloudflare/workers-site-npm-pkg#readme","dependencies":{"mime":"^2.4.4"},"ava":{"require":["esm"]},"devDependencies":{"@cloudflare/workers-types":"^1.0.1","ava":"^1.4.1","service-worker-mock":"^2.0.3","prettier":"^1.18.2"},"gitHead":"a0d79656e6e4572af9018d2446be6df4333ade64","_id":"@cloudflare/kv-asset-handler@0.0.1","_nodeVersion":"10.16.0","_npmVersion":"6.10.1","dist":{"shasum":"7331d5f42377459d93e0cd0abc15a24f4d717205","size":2686,"noattachment":false,"key":"/@cloudflare/kv-asset-handler/-/@cloudflare/kv-asset-handler-0.0.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/@cloudflare/kv-asset-handler/download/@cloudflare/kv-asset-handler-0.0.1.tgz"},"maintainers":[{"name":"wrangler-publisher","email":""}],"_npmUser":{"name":"ag_dubs","email":"ashley666ashley@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/kv-asset-handler_0.0.1_1568936700441_0.10696057950972437"},"_hasShrinkwrap":false,"publish_time":1568936700594,"_cnpm_publish_time":1568936700594,"_cnpmcore_publish_time":"2021-12-16T23:26:08.843Z"}},"readme":"# @cloudflare/kv-asset-handler\n\n[![npm](https://img.shields.io/npm/v/@cloudflare/kv-asset-handler.svg)](https://www.npmjs.com/package/@cloudflare/kv-asset-handler) &nbsp;\n[![Run npm tests](https://github.com/cloudflare/kv-asset-handler/actions/workflows/test.yml/badge.svg)](https://github.com/cloudflare/kv-asset-handler/actions/workflows/test.yml) &nbsp;\n[![Lint Markdown](https://github.com/cloudflare/kv-asset-handler/actions/workflows/lint.yml/badge.svg)](https://github.com/cloudflare/kv-asset-handler/actions/workflows/lint.yml) &nbsp;\n\n`kv-asset-handler` is an open-source library for managing the retrieval of static assets from [Workers KV](https://developers.cloudflare.com/workers/runtime-apis/kv) inside of a [Cloudflare Workers](https://workers.dev) function. `kv-asset-handler` is designed for use with [Workers Sites](https://developers.cloudflare.com/workers/platform/sites), a feature included in [Wrangler](https://github.com/cloudflare/wrangler), our command-line tool for deploying Workers projects.\n\n`kv-asset-handler` runs as part of a Cloudflare Workers function, so it allows you to customize _how_ and _when_ your static assets are loaded, as well as customize how those assets behave before they're sent to the client.\n\nMost users and sites will not need these customizations, and just want to serve their statically built applications. For that simple use-case, you can check out [Cloudflare Pages](https://pages.cloudflare.com), our batteries-included approach to deploying static sites on Cloudflare's edge network. Workers Sites was designed as a precursor to Cloudflare Pages, so check out Pages if you just want to deploy your static site without any special customizations!\n\nFor users who _do_ want to customize their assets, and want to build complex experiences on top of their static assets, `kv-asset-handler` (and the default [Workers Sites template](https://github.com/cloudflare/worker-sites-template), which is provided for use with Wrangler + Workers Sites) allows you to customize caching behavior, headers, and anything else about how your Workers function loads the static assets for your site stored in Workers KV.\n\nThe Cloudflare Workers Discord server is an active place where Workers users get help, share feedback, and collaborate on making our platform better. The `#workers` channel in particular is a great place to chat about `kv-asset-handler`, and building cool experiences for your users using these tools! If you have questions, want to share what you're working on, or give feedback, [join us in Discord and say hello](https://discord.gg/cloudflaredev)!\n\n- [Installation](#installation)\n- [Usage](#usage)\n- [`getAssetFromKV`](#-getassetfromkv)\n  - [Example](#example)\n  * [Return](#return)\n  * [Optional Arguments](#optional-arguments)\n    - [`mapRequestToAsset`](#-maprequesttoasset)\n    - [Example](#example-1)\n    - [`cacheControl`](#-cachecontrol)\n      - [`browserTTL`](#browserttl)\n      - [`edgeTTL`](#edgettl)\n      - [`bypassCache`](#bypasscache)\n    - [`ASSET_NAMESPACE` (required for ES Modules)](#asset_namespace-required-for-es-modules)\n    - [`ASSET_MANIFEST` (required for ES Modules)](#asset_manifest-required-for-es-modules)\n    - [`defaultETag`](#defaultetag-optional)\n\n* [Helper functions](#helper-functions)\n  - [`mapRequestToAsset`](#maprequesttoasset-1)\n  - [`serveSinglePageApp`](#servesinglepageapp)\n* [Cache revalidation and etags](#cache-revalidation-and-etags)\n\n## Installation\n\nAdd this package to your `package.json` by running this in the root of your\nproject's directory:\n\n```\nnpm i @cloudflare/kv-asset-handler\n```\n\n## Usage\n\nThis package was designed to work with [Worker Sites](https://workers.cloudflare.com/sites).\n\n## `getAssetFromKV`\n\ngetAssetFromKV(Evt) => Promise<Response>\n\n`getAssetFromKV` is an async function that takes an `Evt` object (containing a `Request` and a [`waitUntil`](https://developers.cloudflare.com/workers/runtime-apis/fetch-event#waituntil)) and returns a `Response` object if the request matches an asset in KV, otherwise it will throw a `KVError`.\n\n#### Example\n\nThis example checks for the existence of a value in KV, and returns it if it's there, and returns a 404 if it is not. It also serves index.html from `/`.\n\n### Return\n\n`getAssetFromKV` returns a `Promise<Response>` with `Response` being the body of the asset requested.\n\nKnown errors to be thrown are:\n\n- MethodNotAllowedError\n- NotFoundError\n- InternalError\n\n#### ES Modules\n\n```js\nimport { getAssetFromKV, NotFoundError, MethodNotAllowedError } from '@cloudflare/kv-asset-handler'\nimport manifestJSON from '__STATIC_CONTENT_MANIFEST'\nconst assetManifest = JSON.parse(manifestJSON)\n\nexport default {\n\tasync fetch(request, env, ctx) {\n\t\tif (request.url.includes('/docs')) {\n\t\t\ttry {\n\t\t\t\treturn await getAssetFromKV(\n\t\t\t\t\t{\n\t\t\t\t\t\trequest,\n\t\t\t\t\t\twaitUntil(promise) {\n\t\t\t\t\t\t\treturn ctx.waitUntil(promise)\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tASSET_NAMESPACE: env.__STATIC_CONTENT,\n\t\t\t\t\t\tASSET_MANIFEST: assetManifest,\n\t\t\t\t\t},\n\t\t\t\t)\n\t\t\t} catch (e) {\n\t\t\t\tif (e instanceof NotFoundError) {\n\t\t\t\t\t// ...\n\t\t\t\t} else if (e instanceof MethodNotAllowedError) {\n\t\t\t\t\t// ...\n\t\t\t\t} else {\n\t\t\t\t\treturn new Response('An unexpected error occurred', { status: 500 })\n\t\t\t\t}\n\t\t\t}\n\t\t} else return fetch(request)\n\t},\n}\n```\n\n#### Service Worker\n\n```js\nimport { getAssetFromKV, NotFoundError, MethodNotAllowedError } from '@cloudflare/kv-asset-handler'\n\naddEventListener('fetch', (event) => {\n\tevent.respondWith(handleEvent(event))\n})\n\nasync function handleEvent(event) {\n\tif (event.request.url.includes('/docs')) {\n\t\ttry {\n\t\t\treturn await getAssetFromKV(event)\n\t\t} catch (e) {\n\t\t\tif (e instanceof NotFoundError) {\n\t\t\t\t// ...\n\t\t\t} else if (e instanceof MethodNotAllowedError) {\n\t\t\t\t// ...\n\t\t\t} else {\n\t\t\t\treturn new Response('An unexpected error occurred', { status: 500 })\n\t\t\t}\n\t\t}\n\t} else return fetch(event.request)\n}\n```\n\n### Optional Arguments\n\nYou can customize the behavior of `getAssetFromKV` by passing the following properties as an object into the second argument.\n\n```\ngetAssetFromKV(event, { mapRequestToAsset: ... })\n```\n\n#### `mapRequestToAsset`\n\nmapRequestToAsset(Request) => Request\n\nMaps the incoming request to the value that will be looked up in Cloudflare's KV\n\nBy default, mapRequestToAsset is set to the exported function [`mapRequestToAsset`](#maprequesttoasset-1). This works for most static site generators, but you can customize this behavior by passing your own function as `mapRequestToAsset`. The function should take a `Request` object as its only argument, and return a new `Request` object with an updated path to be looked up in the asset manifest/KV.\n\nFor SPA mapping pass in the [`serveSinglePageApp`](#servesinglepageapp) function\n\n#### Example\n\nStrip `/docs` from any incoming request before looking up an asset in Cloudflare's KV.\n\n```js\nimport { getAssetFromKV, mapRequestToAsset } from '@cloudflare/kv-asset-handler'\n...\nconst customKeyModifier = request => {\n  let url = request.url\n  //custom key mapping optional\n  url = url.replace('/docs', '').replace(/^\\/+/, '')\n  return mapRequestToAsset(new Request(url, request))\n}\nlet asset = await getAssetFromKV(event, { mapRequestToAsset: customKeyModifier })\n```\n\n#### `cacheControl`\n\ntype: object\n\n`cacheControl` allows you to configure options for both the Cloudflare Cache accessed by your Worker, and the browser cache headers sent along with your Workers' responses. The default values are as follows:\n\n```javascript\nlet cacheControl = {\n\tbrowserTTL: null, // do not set cache control ttl on responses\n\tedgeTTL: 2 * 60 * 60 * 24, // 2 days\n\tbypassCache: false, // do not bypass Cloudflare's cache\n}\n```\n\n##### `browserTTL`\n\ntype: number | null\nnullable: true\n\nSets the `Cache-Control: max-age` header on the response returned from the Worker. By default set to `null` which will not add the header at all.\n\n##### `edgeTTL`\n\ntype: number | null\nnullable: true\n\nSets the `Cache-Control: max-age` header on the response used as the edge cache key. By default set to 2 days (`2 * 60 * 60 * 24`). When null will not cache on the edge at all.\n\n##### `bypassCache`\n\ntype: boolean\n\nDetermines whether to cache requests on Cloudflare's edge cache. By default set to `false` (recommended for production builds). Useful for development when you need to eliminate the cache's effect on testing.\n\n#### `ASSET_NAMESPACE` (required for ES Modules)\n\ntype: KV Namespace Binding\n\nThe binding name to the KV Namespace populated with key/value entries of files for the Worker to serve. By default, Workers Sites uses a [binding to a Workers KV Namespace](https://developers.cloudflare.com/workers/reference/storage/api/#namespaces) named `__STATIC_CONTENT`.\n\nIt is further assumed that this namespace consists of static assets such as HTML, CSS, JavaScript, or image files, keyed off of a relative path that roughly matches the assumed URL pathname of the incoming request.\n\nIn ES Modules format, this argument is required, and can be gotten from `env`.\n\n##### ES Module\n\n```js\nreturn getAssetFromKV(\n\t{\n\t\trequest,\n\t\twaitUntil(promise) {\n\t\t\treturn ctx.waitUntil(promise)\n\t\t},\n\t},\n\t{\n\t\tASSET_NAMESPACE: env.__STATIC_CONTENT,\n\t},\n)\n```\n\n##### Service Worker\n\n```\nreturn getAssetFromKV(event, { ASSET_NAMESPACE: MY_NAMESPACE })\n```\n\n#### `ASSET_MANIFEST` (required for ES Modules)\n\ntype: text blob (JSON formatted) or object\n\nThe mapping of requested file path to the key stored on Cloudflare.\n\nWorkers Sites with Wrangler bundles up a text blob that maps request paths to content-hashed keys that are generated by Wrangler as a cache-busting measure. If this option/binding is not present, the function will fallback to using the raw pathname to look up your asset in KV. If, for whatever reason, you have rolled your own implementation of this, you can include your own by passing a stringified JSON object where the keys are expected paths, and the values are the expected keys in your KV namespace.\n\nIn ES Modules format, this argument is required, and can be imported.\n\n##### ES Module\n\n```js\nimport manifestJSON from '__STATIC_CONTENT_MANIFEST'\nlet manifest = JSON.parse(manifestJSON)\nmanifest['index.html'] = 'index.special.html'\n\nreturn getAssetFromKV(\n\t{\n\t\trequest,\n\t\twaitUntil(promise) {\n\t\t\treturn ctx.waitUntil(promise)\n\t\t},\n\t},\n\t{\n\t\tASSET_MANIFEST: manifest,\n\t\t// ...\n\t},\n)\n```\n\n##### Service Worker\n\n```\nlet assetManifest = { \"index.html\": \"index.special.html\" }\nreturn getAssetFromKV(event, { ASSET_MANIFEST: assetManifest })\n```\n\n#### `defaultMimeType` (optional)\n\ntype: string\n\nThis is the mime type that will be used for files with unrecognized or missing extensions. The default value is `'text/plain'`.\n\nIf you are serving a static site and would like to use extensionless HTML files instead of index.html files, set this to `'text/html'`.\n\n#### `defaultDocument` (optional)\n\ntype: string\n\nThis is the default document that will be concatenated for requests ends in `'/'` or without a valid mime type like `'/about'` or `'/about.me'`. The default value is `'index.html'`.\n\n#### `defaultETag` (optional)\n\ntype: `'strong' | 'weak'`\n\nThis determines the format of the response [ETag header](https://developer.mozilla.org/docs/Web/HTTP/Headers/ETag). If the resource is in the cache, the ETag will always be weakened before being returned.\nThe default value is `'strong'`.\n\n# Helper functions\n\n## `mapRequestToAsset`\n\nmapRequestToAsset(Request) => Request\n\nThe default function for mapping incoming requests to keys in Cloudflare's KV.\n\nTakes any path that ends in `/` or evaluates to an HTML file and appends `index.html` or `/index.html` for lookup in your Workers KV namespace.\n\n## `serveSinglePageApp`\n\nserveSinglePageApp(Request) => Request\n\nA custom handler for mapping requests to a single root: `index.html`. The most common use case is single-page applications - frameworks with in-app routing - such as React Router, VueJS, etc. It takes zero arguments.\n\n```js\nimport { getAssetFromKV, serveSinglePageApp } from '@cloudflare/kv-asset-handler'\n...\nlet asset = await getAssetFromKV(event, { mapRequestToAsset: serveSinglePageApp })\n```\n\n# Cache revalidation and etags\n\nAll responses served from cache (including those with `cf-cache-status: MISS`) include an `etag` response header that identifies the version of the resource. The `etag` value is identical to the path key used in the `ASSET_MANIFEST`. It is updated each time an asset changes and looks like this: `etag: <filename>.<hash of file contents>.<extension>` (ex. `etag: index.54321.html`).\n\nResources served with an `etag` allow browsers to use the `if-none-match` request header to make conditional requests for that resource in the future. This has two major benefits:\n\n- When a request's `if-none-match` value matches the `etag` of the resource in Cloudflare cache, Cloudflare will send a `304 Not Modified` response without a body, saving bandwidth.\n- Changes to a file on the server are immediately reflected in the browser - even when the cache control directive `max-age` is unexpired.\n\n#### Disable the `etag`\n\nTo turn `etags` **off**, you must bypass cache:\n\n```js\n/* Turn etags off */\nlet cacheControl = {\n\tbypassCache: true,\n}\n```\n\n#### Syntax and comparison context\n\n`kv-asset-handler` sets and evaluates etags as [strong validators](https://developer.mozilla.org/en-US/docs/Web/HTTP/Conditional_requests#Strong_validation). To preserve `etag` integrity, the format of the value deviates from the [RFC2616 recommendation to enclose the `etag` with quotation marks](https://tools.ietf.org/html/rfc2616#section-3.11). This is intentional. Cloudflare cache applies the `W/` prefix to all `etags` that use quoted-strings -- a process that converts the `etag` to a \"weak validator\" when served to a client.\n","_attachments":{},"homepage":"https://github.com/cloudflare/kv-asset-handler#readme","bugs":{"url":"https://github.com/cloudflare/kv-asset-handler/issues"},"license":"MIT OR Apache-2.0"}