wrangler 0.0.0-e452a04 → 0.0.0-e464fcdb

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (379) hide show
  1. package/Cloudflare_CA.pem +18 -0
  2. package/README.md +47 -14
  3. package/bin/wrangler.js +181 -29
  4. package/kv-asset-handler.js +1 -0
  5. package/miniflare-dist/index.mjs +6442 -0
  6. package/package.json +198 -140
  7. package/src/__tests__/access.test.ts +25 -0
  8. package/src/__tests__/api-dev.test.ts +238 -0
  9. package/src/__tests__/api-devregistry.test.ts +121 -0
  10. package/src/__tests__/api.test.ts +102 -0
  11. package/src/__tests__/config-cache-without-cache-dir.test.ts +38 -0
  12. package/src/__tests__/config-cache.test.ts +42 -0
  13. package/src/__tests__/configuration.test.ts +4501 -2209
  14. package/src/__tests__/constellation.test.ts +371 -0
  15. package/src/__tests__/d1/d1.test.ts +82 -0
  16. package/src/__tests__/d1/execute.test.ts +66 -0
  17. package/src/__tests__/d1/migrate.test.ts +257 -0
  18. package/src/__tests__/d1/splitter.test.ts +255 -0
  19. package/src/__tests__/delete.test.ts +272 -0
  20. package/src/__tests__/deployments.test.ts +369 -0
  21. package/src/__tests__/dev.test.tsx +1604 -392
  22. package/src/__tests__/generate.test.ts +237 -0
  23. package/src/__tests__/get-host-from-url.test.ts +16 -0
  24. package/src/__tests__/guess-worker-format.test.ts +113 -51
  25. package/src/__tests__/helpers/cmd-shim.d.ts +6 -6
  26. package/src/__tests__/helpers/end-event-loop.ts +6 -0
  27. package/src/__tests__/helpers/mock-account-id.ts +26 -22
  28. package/src/__tests__/helpers/mock-auth-domain.ts +20 -0
  29. package/src/__tests__/helpers/mock-bin.ts +20 -20
  30. package/src/__tests__/helpers/mock-console.ts +74 -32
  31. package/src/__tests__/helpers/mock-dialogs.ts +107 -33
  32. package/src/__tests__/helpers/mock-get-pages-upload-token.ts +25 -0
  33. package/src/__tests__/helpers/mock-get-zone-from-host.ts +11 -0
  34. package/src/__tests__/helpers/mock-http-server.ts +46 -0
  35. package/src/__tests__/helpers/mock-istty.ts +74 -0
  36. package/src/__tests__/helpers/mock-known-routes.ts +12 -0
  37. package/src/__tests__/helpers/mock-kv.ts +42 -36
  38. package/src/__tests__/helpers/mock-oauth-flow.ts +263 -0
  39. package/src/__tests__/helpers/mock-process.ts +34 -0
  40. package/src/__tests__/helpers/mock-set-timeout.ts +16 -0
  41. package/src/__tests__/helpers/mock-stdin.ts +82 -77
  42. package/src/__tests__/helpers/mock-web-socket.ts +21 -21
  43. package/src/__tests__/helpers/msw/blob-worker.cjs +19 -0
  44. package/src/__tests__/helpers/msw/handlers/access.ts +13 -0
  45. package/src/__tests__/helpers/msw/handlers/deployments.ts +160 -0
  46. package/src/__tests__/helpers/msw/handlers/namespaces.ts +81 -0
  47. package/src/__tests__/helpers/msw/handlers/oauth.ts +31 -0
  48. package/src/__tests__/helpers/msw/handlers/r2.ts +60 -0
  49. package/src/__tests__/helpers/msw/handlers/script.ts +56 -0
  50. package/src/__tests__/helpers/msw/handlers/user.ts +52 -0
  51. package/src/__tests__/helpers/msw/handlers/zones.ts +20 -0
  52. package/src/__tests__/helpers/msw/index.ts +52 -0
  53. package/src/__tests__/helpers/msw/read-file-sync.js +61 -0
  54. package/src/__tests__/helpers/run-in-tmp.ts +29 -20
  55. package/src/__tests__/helpers/run-wrangler.ts +8 -8
  56. package/src/__tests__/helpers/string-dynamic-values-matcher.ts +28 -0
  57. package/src/__tests__/helpers/worker-scripts/child-wrangler.toml +1 -0
  58. package/src/__tests__/helpers/worker-scripts/hello-world-worker.js +5 -0
  59. package/src/__tests__/helpers/worker-scripts/hello-world-wrangler.toml +1 -0
  60. package/src/__tests__/helpers/worker-scripts/parent-worker.js +11 -0
  61. package/src/__tests__/helpers/worker-scripts/parent-wrangler.toml +5 -0
  62. package/src/__tests__/helpers/write-worker-source.ts +31 -0
  63. package/src/__tests__/helpers/write-wrangler-toml.ts +9 -9
  64. package/src/__tests__/https-options.test.ts +144 -108
  65. package/src/__tests__/index.test.ts +266 -975
  66. package/src/__tests__/init.test.ts +3196 -0
  67. package/src/__tests__/jest.setup.ts +158 -48
  68. package/src/__tests__/kv.test.ts +1789 -1398
  69. package/src/__tests__/logger.test.ts +207 -0
  70. package/src/__tests__/logout.test.ts +41 -44
  71. package/src/__tests__/metrics.test.ts +493 -0
  72. package/src/__tests__/middleware.scheduled.test.ts +145 -0
  73. package/src/__tests__/middleware.test.ts +816 -0
  74. package/src/__tests__/mtls-certificates.test.ts +589 -0
  75. package/src/__tests__/package-manager.test.ts +312 -165
  76. package/src/__tests__/pages/deployment-list.test.ts +80 -0
  77. package/src/__tests__/pages/functions-build.test.ts +452 -0
  78. package/src/__tests__/pages/pages.test.ts +81 -0
  79. package/src/__tests__/pages/project-create.test.ts +63 -0
  80. package/src/__tests__/pages/project-list.test.ts +110 -0
  81. package/src/__tests__/pages/project-upload.test.ts +500 -0
  82. package/src/__tests__/pages/publish.test.ts +2864 -0
  83. package/src/__tests__/pages-deployment-tail.test.ts +955 -0
  84. package/src/__tests__/parse.test.ts +359 -245
  85. package/src/__tests__/paths.test.ts +39 -0
  86. package/src/__tests__/publish.test.ts +8796 -2199
  87. package/src/__tests__/pubsub.test.ts +496 -0
  88. package/src/__tests__/queues.test.ts +532 -0
  89. package/src/__tests__/r2.test.ts +369 -193
  90. package/src/__tests__/route.test.ts +22 -22
  91. package/src/__tests__/secret.test.ts +683 -415
  92. package/src/__tests__/tail.test.ts +838 -444
  93. package/src/__tests__/test-old-node-version.js +31 -0
  94. package/src/__tests__/traverse-module-graph.test.ts +220 -0
  95. package/src/__tests__/tsconfig-sanity.ts +12 -0
  96. package/src/__tests__/tsconfig.json +8 -0
  97. package/src/__tests__/tsconfig.tsbuildinfo +1 -0
  98. package/src/__tests__/type-generation.test.ts +234 -0
  99. package/src/__tests__/user.test.ts +118 -0
  100. package/src/__tests__/utils-collectKeyValues.test.ts +47 -0
  101. package/src/__tests__/validate-dev-props.test.ts +56 -0
  102. package/src/__tests__/version.test.ts +35 -0
  103. package/src/__tests__/whoami.test.tsx +167 -81
  104. package/src/__tests__/worker-namespace.test.ts +340 -0
  105. package/src/abort.d.ts +3 -0
  106. package/src/api/dev.ts +316 -0
  107. package/src/api/index.ts +11 -0
  108. package/src/api/mtls-certificate.ts +148 -0
  109. package/src/api/pages/create-worker-bundle-contents.ts +76 -0
  110. package/src/api/pages/index.ts +5 -0
  111. package/src/api/pages/publish.tsx +355 -0
  112. package/src/bundle-reporter.ts +68 -0
  113. package/src/bundle.ts +876 -110
  114. package/src/cfetch/index.ts +123 -69
  115. package/src/cfetch/internal.ts +217 -94
  116. package/src/cli.ts +23 -14
  117. package/src/config/README.md +7 -7
  118. package/src/config/config.ts +232 -229
  119. package/src/config/diagnostics.ts +61 -61
  120. package/src/config/environment.ts +569 -256
  121. package/src/config/index.ts +385 -34
  122. package/src/config/validation-helpers.ts +448 -239
  123. package/src/config/validation.ts +2227 -912
  124. package/src/config-cache.ts +85 -0
  125. package/src/constellation/createProject.tsx +51 -0
  126. package/src/constellation/deleteProject.ts +51 -0
  127. package/src/constellation/deleteProjectModel.ts +68 -0
  128. package/src/constellation/index.ts +75 -0
  129. package/src/constellation/listCatalog.tsx +35 -0
  130. package/src/constellation/listModel.tsx +41 -0
  131. package/src/constellation/listProject.tsx +28 -0
  132. package/src/constellation/listRuntime.tsx +28 -0
  133. package/src/constellation/options.ts +17 -0
  134. package/src/constellation/types.ts +17 -0
  135. package/src/constellation/uploadModel.tsx +64 -0
  136. package/src/constellation/utils.ts +90 -0
  137. package/src/create-worker-preview.ts +251 -124
  138. package/src/create-worker-upload-form.ts +343 -201
  139. package/src/d1/backups.tsx +219 -0
  140. package/src/d1/constants.ts +6 -0
  141. package/src/d1/create.tsx +103 -0
  142. package/src/d1/delete.ts +53 -0
  143. package/src/d1/execute.tsx +371 -0
  144. package/src/d1/formatTimeAgo.ts +14 -0
  145. package/src/d1/index.ts +100 -0
  146. package/src/d1/list.tsx +62 -0
  147. package/src/d1/migrations/apply.tsx +235 -0
  148. package/src/d1/migrations/create.tsx +79 -0
  149. package/src/d1/migrations/helpers.ts +171 -0
  150. package/src/d1/migrations/index.ts +3 -0
  151. package/src/d1/migrations/list.tsx +95 -0
  152. package/src/d1/migrations/options.ts +23 -0
  153. package/src/d1/options.ts +22 -0
  154. package/src/d1/splitter.ts +161 -0
  155. package/src/d1/types.ts +32 -0
  156. package/src/d1/utils.ts +49 -0
  157. package/src/delete.ts +100 -0
  158. package/src/deployments.ts +368 -0
  159. package/src/deprecated/index.ts +144 -0
  160. package/src/dev/dev-vars.ts +39 -0
  161. package/src/dev/dev.tsx +544 -301
  162. package/src/dev/get-local-persistence-path.ts +31 -0
  163. package/src/dev/local.tsx +934 -227
  164. package/src/dev/remote.tsx +621 -190
  165. package/src/dev/start-server.ts +534 -0
  166. package/src/dev/use-esbuild.ts +183 -80
  167. package/src/dev/validate-dev-props.ts +40 -0
  168. package/src/dev-registry.ts +202 -0
  169. package/src/dev.tsx +929 -0
  170. package/src/dialogs.ts +136 -0
  171. package/src/dispatch-namespace.ts +211 -0
  172. package/src/docs/helpers.ts +50 -0
  173. package/src/docs/index.ts +54 -0
  174. package/src/durable.ts +102 -0
  175. package/src/entry.ts +288 -110
  176. package/src/environment-variables/factory.ts +89 -0
  177. package/src/environment-variables/misc-variables.ts +30 -0
  178. package/src/errors.ts +11 -0
  179. package/src/generate/index.ts +298 -0
  180. package/src/git-client.ts +135 -0
  181. package/src/global-wrangler-config-path.ts +26 -0
  182. package/src/https-options.ts +85 -80
  183. package/src/index.ts +768 -0
  184. package/src/init.ts +1032 -0
  185. package/src/inspect.ts +722 -557
  186. package/src/intl-polyfill.d.ts +139 -0
  187. package/src/is-ci.ts +14 -0
  188. package/src/is-interactive.ts +16 -0
  189. package/src/jest.d.ts +4 -0
  190. package/src/kv/helpers.ts +433 -0
  191. package/src/kv/index.ts +594 -0
  192. package/src/logger.ts +123 -0
  193. package/src/metrics/index.ts +5 -0
  194. package/src/metrics/metrics-config.ts +239 -0
  195. package/src/metrics/metrics-dispatcher.ts +96 -0
  196. package/src/metrics/metrics-usage-headers.ts +24 -0
  197. package/src/metrics/send-event.ts +99 -0
  198. package/src/miniflare-cli/README.md +30 -0
  199. package/src/miniflare-cli/assets.ts +251 -0
  200. package/src/miniflare-cli/index.ts +210 -0
  201. package/src/miniflare-cli/request-context.ts +40 -0
  202. package/src/miniflare-cli/tsconfig.json +9 -0
  203. package/src/miniflare-cli/tsconfig.tsbuildinfo +1 -0
  204. package/src/miniflare-cli/types.ts +11 -0
  205. package/src/module-collection.ts +307 -227
  206. package/src/mtls-certificate/cli.ts +155 -0
  207. package/src/open-in-browser.ts +8 -16
  208. package/src/package-manager.ts +183 -90
  209. package/src/pages/build.ts +410 -0
  210. package/src/pages/buildFunctions.ts +140 -0
  211. package/src/pages/constants.ts +18 -0
  212. package/src/pages/deployment-tails.ts +281 -0
  213. package/src/pages/deployments.tsx +84 -0
  214. package/src/pages/dev.ts +716 -0
  215. package/src/pages/errors.ts +67 -0
  216. package/src/pages/functions/buildPlugin.ts +113 -0
  217. package/src/pages/functions/buildWorker.ts +291 -0
  218. package/src/pages/functions/filepath-routing.test.ts +234 -0
  219. package/src/pages/functions/filepath-routing.ts +189 -0
  220. package/src/pages/functions/identifiers.ts +78 -0
  221. package/src/pages/functions/routes-consolidation.test.ts +250 -0
  222. package/src/pages/functions/routes-consolidation.ts +73 -0
  223. package/src/pages/functions/routes-transformation.test.ts +282 -0
  224. package/src/pages/functions/routes-transformation.ts +115 -0
  225. package/src/pages/functions/routes-validation.test.ts +403 -0
  226. package/src/pages/functions/routes-validation.ts +202 -0
  227. package/src/pages/functions/routes.ts +151 -0
  228. package/src/pages/functions/tsconfig.json +8 -0
  229. package/src/pages/functions/tsconfig.tsbuildinfo +1 -0
  230. package/src/pages/functions.ts +86 -0
  231. package/src/pages/hash.ts +13 -0
  232. package/src/pages/index.ts +102 -0
  233. package/src/pages/projects.tsx +159 -0
  234. package/src/pages/prompt-select-project.tsx +31 -0
  235. package/src/pages/publish.tsx +267 -0
  236. package/src/pages/types.ts +46 -0
  237. package/src/pages/upload.tsx +469 -0
  238. package/src/pages/utils.ts +23 -0
  239. package/src/parse.ts +247 -122
  240. package/src/paths.ts +53 -8
  241. package/src/proxy.ts +629 -373
  242. package/src/publish/index.ts +274 -0
  243. package/src/publish/publish.ts +1060 -0
  244. package/src/pubsub/index.ts +286 -0
  245. package/src/pubsub/pubsub-commands.ts +623 -0
  246. package/src/queues/cli/commands/consumer/add.ts +71 -0
  247. package/src/queues/cli/commands/consumer/index.ts +19 -0
  248. package/src/queues/cli/commands/consumer/remove.ts +31 -0
  249. package/src/queues/cli/commands/create.ts +25 -0
  250. package/src/queues/cli/commands/delete.ts +26 -0
  251. package/src/queues/cli/commands/index.ts +35 -0
  252. package/src/queues/cli/commands/list.ts +25 -0
  253. package/src/queues/client.ts +136 -0
  254. package/src/queues/utils.ts +18 -0
  255. package/src/r2/constants.ts +4 -0
  256. package/src/r2/helpers.ts +132 -0
  257. package/src/r2/index.ts +289 -0
  258. package/src/routes.ts +140 -0
  259. package/src/secret/index.ts +376 -0
  260. package/src/selfsigned.d.ts +23 -23
  261. package/src/sites.ts +484 -0
  262. package/src/tail/createTail.ts +406 -0
  263. package/src/tail/filters.ts +109 -111
  264. package/src/tail/index.ts +208 -296
  265. package/src/tail/printing.ts +107 -47
  266. package/src/traverse-module-graph.ts +53 -0
  267. package/src/tsconfig-sanity.ts +16 -0
  268. package/src/type-generation.ts +181 -0
  269. package/src/update-check.ts +19 -0
  270. package/src/user/access.ts +68 -0
  271. package/src/user/auth-variables.ts +113 -0
  272. package/src/user/choose-account.tsx +39 -0
  273. package/src/user/generate-auth-url.ts +33 -0
  274. package/src/user/generate-random-state.ts +16 -0
  275. package/src/user/index.ts +2 -0
  276. package/src/user/user.ts +1234 -0
  277. package/src/utils/collectKeyValues.ts +14 -0
  278. package/src/utils/render.ts +93 -0
  279. package/src/whoami.ts +135 -0
  280. package/src/worker.ts +211 -100
  281. package/src/yargs-types.ts +37 -0
  282. package/src/zones.ts +191 -0
  283. package/templates/__tests__/pages-dev-util.test.ts +128 -0
  284. package/templates/__tests__/tsconfig-sanity.ts +12 -0
  285. package/templates/__tests__/tsconfig.json +8 -0
  286. package/templates/__tests__/tsconfig.tsbuildinfo +1 -0
  287. package/templates/checked-fetch.js +23 -0
  288. package/templates/d1-beta-facade.js +244 -0
  289. package/templates/facade.d.ts +14 -0
  290. package/templates/first-party-worker-module-facade.ts +19 -0
  291. package/templates/format-dev-errors.ts +34 -0
  292. package/templates/gitignore +172 -0
  293. package/templates/init-tests/test-jest-new-worker.js +23 -0
  294. package/templates/init-tests/test-vitest-new-worker.js +24 -0
  295. package/templates/init-tests/test-vitest-new-worker.ts +25 -0
  296. package/templates/middleware/common.ts +62 -0
  297. package/templates/middleware/loader-modules.ts +84 -0
  298. package/templates/middleware/loader-sw.ts +233 -0
  299. package/templates/middleware/middleware-miniflare3-json-error.ts +32 -0
  300. package/templates/middleware/middleware-pretty-error.ts +40 -0
  301. package/templates/middleware/middleware-scheduled.ts +15 -0
  302. package/templates/new-worker-scheduled.js +17 -0
  303. package/templates/new-worker-scheduled.ts +32 -0
  304. package/templates/new-worker.js +3 -3
  305. package/templates/new-worker.ts +21 -3
  306. package/templates/no-op-worker.js +10 -0
  307. package/templates/pages-dev-pipeline.ts +31 -0
  308. package/templates/pages-dev-util.ts +52 -0
  309. package/templates/pages-shim.ts +12 -0
  310. package/templates/pages-template-plugin.ts +180 -0
  311. package/templates/pages-template-worker.ts +189 -0
  312. package/templates/serve-static-assets.ts +66 -0
  313. package/templates/service-bindings-module-facade.js +55 -0
  314. package/templates/service-bindings-sw-facade.js +42 -0
  315. package/templates/tsconfig-sanity.ts +11 -0
  316. package/templates/tsconfig.init.json +105 -0
  317. package/templates/tsconfig.json +6 -103
  318. package/templates/tsconfig.tsbuildinfo +1 -0
  319. package/wrangler-dist/cli.d.ts +1641 -0
  320. package/wrangler-dist/cli.js +146057 -132724
  321. package/wrangler-dist/wasm-sync.wasm +0 -0
  322. package/pages/functions/buildWorker.ts +0 -62
  323. package/pages/functions/filepath-routing.test.ts +0 -123
  324. package/pages/functions/filepath-routing.ts +0 -178
  325. package/pages/functions/identifiers.ts +0 -78
  326. package/pages/functions/routes.ts +0 -151
  327. package/pages/functions/template-worker.ts +0 -130
  328. package/src/__tests__/dev2.test.tsx +0 -152
  329. package/src/__tests__/helpers/faye-websocket.d.ts +0 -6
  330. package/src/__tests__/helpers/mock-cfetch.ts +0 -207
  331. package/src/__tests__/helpers/mock-user.ts +0 -27
  332. package/src/__tests__/pages.test.ts +0 -44
  333. package/src/__tests__/sentry.test.ts +0 -146
  334. package/src/dialogs.tsx +0 -77
  335. package/src/environment-variables.ts +0 -33
  336. package/src/index.tsx +0 -2329
  337. package/src/kv/index.tsx +0 -339
  338. package/src/pages.tsx +0 -1045
  339. package/src/publish.ts +0 -352
  340. package/src/r2.ts +0 -50
  341. package/src/reporting.ts +0 -131
  342. package/src/sites.tsx +0 -238
  343. package/src/user.tsx +0 -1065
  344. package/src/whoami.tsx +0 -69
  345. package/templates/static-asset-facade.js +0 -47
  346. package/vendor/@cloudflare/kv-asset-handler/CHANGELOG.md +0 -332
  347. package/vendor/@cloudflare/kv-asset-handler/LICENSE_APACHE +0 -176
  348. package/vendor/@cloudflare/kv-asset-handler/LICENSE_MIT +0 -25
  349. package/vendor/@cloudflare/kv-asset-handler/README.md +0 -245
  350. package/vendor/@cloudflare/kv-asset-handler/dist/index.d.ts +0 -32
  351. package/vendor/@cloudflare/kv-asset-handler/dist/index.js +0 -354
  352. package/vendor/@cloudflare/kv-asset-handler/dist/mocks.d.ts +0 -13
  353. package/vendor/@cloudflare/kv-asset-handler/dist/mocks.js +0 -148
  354. package/vendor/@cloudflare/kv-asset-handler/dist/test/getAssetFromKV.d.ts +0 -1
  355. package/vendor/@cloudflare/kv-asset-handler/dist/test/getAssetFromKV.js +0 -436
  356. package/vendor/@cloudflare/kv-asset-handler/dist/test/mapRequestToAsset.d.ts +0 -1
  357. package/vendor/@cloudflare/kv-asset-handler/dist/test/mapRequestToAsset.js +0 -40
  358. package/vendor/@cloudflare/kv-asset-handler/dist/test/serveSinglePageApp.d.ts +0 -1
  359. package/vendor/@cloudflare/kv-asset-handler/dist/test/serveSinglePageApp.js +0 -42
  360. package/vendor/@cloudflare/kv-asset-handler/dist/types.d.ts +0 -26
  361. package/vendor/@cloudflare/kv-asset-handler/dist/types.js +0 -31
  362. package/vendor/@cloudflare/kv-asset-handler/package.json +0 -52
  363. package/vendor/@cloudflare/kv-asset-handler/src/index.ts +0 -296
  364. package/vendor/@cloudflare/kv-asset-handler/src/mocks.ts +0 -136
  365. package/vendor/@cloudflare/kv-asset-handler/src/test/getAssetFromKV.ts +0 -464
  366. package/vendor/@cloudflare/kv-asset-handler/src/test/mapRequestToAsset.ts +0 -33
  367. package/vendor/@cloudflare/kv-asset-handler/src/test/serveSinglePageApp.ts +0 -42
  368. package/vendor/@cloudflare/kv-asset-handler/src/types.ts +0 -39
  369. package/vendor/wrangler-mime/CHANGELOG.md +0 -289
  370. package/vendor/wrangler-mime/LICENSE +0 -21
  371. package/vendor/wrangler-mime/Mime.js +0 -97
  372. package/vendor/wrangler-mime/README.md +0 -187
  373. package/vendor/wrangler-mime/cli.js +0 -46
  374. package/vendor/wrangler-mime/index.js +0 -4
  375. package/vendor/wrangler-mime/lite.js +0 -4
  376. package/vendor/wrangler-mime/package.json +0 -52
  377. package/vendor/wrangler-mime/types/other.js +0 -1
  378. package/vendor/wrangler-mime/types/standard.js +0 -1
  379. package/wrangler-dist/cli.js.map +0 -7
package/src/pages.tsx DELETED
@@ -1,1045 +0,0 @@
1
- /* eslint-disable no-shadow */
2
-
3
- import { execSync, spawn } from "node:child_process";
4
- import { existsSync, lstatSync, readFileSync, writeFileSync } from "node:fs";
5
- import { tmpdir } from "node:os";
6
- import { join } from "node:path";
7
- import { URL } from "node:url";
8
- import { watch } from "chokidar";
9
- import { getType } from "mime";
10
- import { buildWorker } from "../pages/functions/buildWorker";
11
- import { generateConfigFromFileTree } from "../pages/functions/filepath-routing";
12
- import { writeRoutesModule } from "../pages/functions/routes";
13
- import openInBrowser from "./open-in-browser";
14
- import { toUrlPath } from "./paths";
15
- import type { Config } from "../pages/functions/routes";
16
- import type { Headers, Request, fetch } from "@miniflare/core";
17
- import type { BuildResult } from "esbuild";
18
- import type { MiniflareOptions } from "miniflare";
19
- import type { BuilderCallback } from "yargs";
20
-
21
- // Defer importing miniflare until we really need it. This takes ~0.5s
22
- // and also modifies some `stream/web` and `undici` prototypes, so we
23
- // don't want to do this if pages commands aren't being called.
24
-
25
- const EXIT_CALLBACKS: (() => void)[] = [];
26
- const EXIT = (message?: string, code?: number) => {
27
- if (message) console.log(message);
28
- if (code) process.exitCode = code;
29
- EXIT_CALLBACKS.forEach((callback) => callback());
30
- process.exit(code);
31
- };
32
-
33
- process.on("SIGINT", () => EXIT());
34
- process.on("SIGTERM", () => EXIT());
35
-
36
- function isWindows() {
37
- return process.platform === "win32";
38
- }
39
-
40
- const SECONDS_TO_WAIT_FOR_PROXY = 5;
41
-
42
- async function sleep(ms: number) {
43
- await new Promise((resolve) => setTimeout(resolve, ms));
44
- }
45
-
46
- function getPids(pid: number) {
47
- const pids: number[] = [pid];
48
- let command: string, regExp: RegExp;
49
-
50
- if (isWindows()) {
51
- command = `wmic process where (ParentProcessId=${pid}) get ProcessId`;
52
- regExp = new RegExp(/(\d+)/);
53
- } else {
54
- command = `pgrep -P ${pid}`;
55
- regExp = new RegExp(/(\d+)/);
56
- }
57
-
58
- try {
59
- const newPids = (
60
- execSync(command)
61
- .toString()
62
- .split("\n")
63
- .map((line) => line.match(regExp))
64
- .filter((line) => line !== null) as RegExpExecArray[]
65
- ).map((match) => parseInt(match[1]));
66
-
67
- pids.push(...newPids.map(getPids).flat());
68
- } catch {}
69
-
70
- return pids;
71
- }
72
-
73
- function getPort(pid: number) {
74
- let command: string, regExp: RegExp;
75
-
76
- if (isWindows()) {
77
- command = "\\windows\\system32\\netstat.exe -nao";
78
- regExp = new RegExp(`TCP\\s+.*:(\\d+)\\s+.*:\\d+\\s+LISTENING\\s+${pid}`);
79
- } else {
80
- command = "lsof -nPi";
81
- regExp = new RegExp(`${pid}\\s+.*TCP\\s+.*:(\\d+)\\s+\\(LISTEN\\)`);
82
- }
83
-
84
- try {
85
- const matches = execSync(command)
86
- .toString()
87
- .split("\n")
88
- .map((line) => line.match(regExp))
89
- .filter((line) => line !== null) as RegExpExecArray[];
90
-
91
- const match = matches[0];
92
- if (match) return parseInt(match[1]);
93
- } catch (thrown) {
94
- console.error(
95
- `Error scanning for ports of process with PID ${pid}: ${thrown}`
96
- );
97
- }
98
- }
99
-
100
- async function spawnProxyProcess({
101
- port,
102
- command,
103
- }: {
104
- port?: number;
105
- command: (string | number)[];
106
- }): Promise<void | number> {
107
- if (command.length === 0)
108
- return EXIT(
109
- "Must specify a directory of static assets to serve or a command to run.",
110
- 1
111
- );
112
-
113
- console.log(`Running ${command.join(" ")}...`);
114
- const proxy = spawn(
115
- command[0].toString(),
116
- command.slice(1).map((value) => value.toString()),
117
- {
118
- shell: isWindows(),
119
- env: {
120
- BROWSER: "none",
121
- ...process.env,
122
- },
123
- }
124
- );
125
- EXIT_CALLBACKS.push(() => {
126
- proxy.kill();
127
- });
128
-
129
- proxy.stdout.on("data", (data) => {
130
- console.log(`[proxy]: ${data}`);
131
- });
132
-
133
- proxy.stderr.on("data", (data) => {
134
- console.error(`[proxy]: ${data}`);
135
- });
136
-
137
- proxy.on("close", (code) => {
138
- console.error(`Proxy exited with status ${code}.`);
139
- });
140
-
141
- // Wait for proxy process to start...
142
- while (!proxy.pid) {}
143
-
144
- if (port === undefined) {
145
- console.log(
146
- `Sleeping ${SECONDS_TO_WAIT_FOR_PROXY} seconds to allow proxy process to start before attempting to automatically determine port...`
147
- );
148
- console.log("To skip, specify the proxy port with --proxy.");
149
- await sleep(SECONDS_TO_WAIT_FOR_PROXY * 1000);
150
-
151
- port = getPids(proxy.pid)
152
- .map(getPort)
153
- .filter((port) => port !== undefined)[0];
154
-
155
- if (port === undefined) {
156
- return EXIT(
157
- "Could not automatically determine proxy port. Please specify the proxy port with --proxy.",
158
- 1
159
- );
160
- } else {
161
- console.log(`Automatically determined the proxy port to be ${port}.`);
162
- }
163
- }
164
-
165
- return port;
166
- }
167
-
168
- function escapeRegex(str: string) {
169
- return str.replace(/[-/\\^$*+?.()|[]{}]/g, "\\$&");
170
- }
171
-
172
- type Replacements = Record<string, string>;
173
-
174
- function replacer(str: string, replacements: Replacements) {
175
- for (const [replacement, value] of Object.entries(replacements)) {
176
- str = str.replace(`:${replacement}`, value);
177
- }
178
- return str;
179
- }
180
-
181
- function generateRulesMatcher<T>(
182
- rules?: Record<string, T>,
183
- replacer: (match: T, replacements: Replacements) => T = (match) => match
184
- ) {
185
- // TODO: How can you test cross-host rules?
186
- if (!rules) return () => [];
187
-
188
- const compiledRules = Object.entries(rules)
189
- .map(([rule, match]) => {
190
- const crossHost = rule.startsWith("https://");
191
-
192
- rule = rule.split("*").map(escapeRegex).join("(?<splat>.*)");
193
-
194
- const host_matches = rule.matchAll(
195
- /(?<=^https:\\\/\\\/[^/]*?):([^\\]+)(?=\\)/g
196
- );
197
- for (const match of host_matches) {
198
- rule = rule.split(match[0]).join(`(?<${match[1]}>[^/.]+)`);
199
- }
200
-
201
- const path_matches = rule.matchAll(/:(\w+)/g);
202
- for (const match of path_matches) {
203
- rule = rule.split(match[0]).join(`(?<${match[1]}>[^/]+)`);
204
- }
205
-
206
- rule = "^" + rule + "$";
207
-
208
- try {
209
- const regExp = new RegExp(rule);
210
- return [{ crossHost, regExp }, match];
211
- } catch {}
212
- })
213
- .filter((value) => value !== undefined) as [
214
- { crossHost: boolean; regExp: RegExp },
215
- T
216
- ][];
217
-
218
- return ({ request }: { request: Request }) => {
219
- const { pathname, host } = new URL(request.url);
220
-
221
- return compiledRules
222
- .map(([{ crossHost, regExp }, match]) => {
223
- const test = crossHost ? `https://${host}${pathname}` : pathname;
224
- const result = regExp.exec(test);
225
- if (result) {
226
- return replacer(match, result.groups || {});
227
- }
228
- })
229
- .filter((value) => value !== undefined) as T[];
230
- };
231
- }
232
-
233
- function generateHeadersMatcher(headersFile: string) {
234
- if (existsSync(headersFile)) {
235
- const contents = readFileSync(headersFile).toString();
236
-
237
- // TODO: Log errors
238
- const lines = contents
239
- .split("\n")
240
- .map((line) => line.trim())
241
- .filter((line) => !line.startsWith("#") && line !== "");
242
-
243
- const rules: Record<string, Record<string, string>> = {};
244
- let rule: { path: string; headers: Record<string, string> } | undefined =
245
- undefined;
246
-
247
- for (const line of lines) {
248
- if (/^([^\s]+:\/\/|^\/)/.test(line)) {
249
- if (rule && Object.keys(rule.headers).length > 0) {
250
- rules[rule.path] = rule.headers;
251
- }
252
-
253
- const path = validateURL(line);
254
- if (path) {
255
- rule = {
256
- path,
257
- headers: {},
258
- };
259
- continue;
260
- }
261
- }
262
-
263
- if (!line.includes(":")) continue;
264
-
265
- const [rawName, ...rawValue] = line.split(":");
266
- const name = rawName.trim().toLowerCase();
267
- const value = rawValue.join(":").trim();
268
-
269
- if (name === "") continue;
270
- if (!rule) continue;
271
-
272
- const existingValues = rule.headers[name];
273
- rule.headers[name] = existingValues
274
- ? `${existingValues}, ${value}`
275
- : value;
276
- }
277
-
278
- if (rule && Object.keys(rule.headers).length > 0) {
279
- rules[rule.path] = rule.headers;
280
- }
281
-
282
- const rulesMatcher = generateRulesMatcher(rules, (match, replacements) =>
283
- Object.fromEntries(
284
- Object.entries(match).map(([name, value]) => [
285
- name,
286
- replacer(value, replacements),
287
- ])
288
- )
289
- );
290
-
291
- return (request: Request) => {
292
- const matches = rulesMatcher({
293
- request,
294
- });
295
- if (matches) return matches;
296
- };
297
- } else {
298
- return () => undefined;
299
- }
300
- }
301
-
302
- function generateRedirectsMatcher(redirectsFile: string) {
303
- if (existsSync(redirectsFile)) {
304
- const contents = readFileSync(redirectsFile).toString();
305
-
306
- // TODO: Log errors
307
- const lines = contents
308
- .split("\n")
309
- .map((line) => line.trim())
310
- .filter((line) => !line.startsWith("#") && line !== "");
311
-
312
- const rules = Object.fromEntries(
313
- lines
314
- .map((line) => line.split(" "))
315
- .filter((tokens) => tokens.length === 2 || tokens.length === 3)
316
- .map((tokens) => {
317
- const from = validateURL(tokens[0], true, false, false);
318
- const to = validateURL(tokens[1], false, true, true);
319
- let status: number | undefined = parseInt(tokens[2]) || 302;
320
- status = [301, 302, 303, 307, 308].includes(status)
321
- ? status
322
- : undefined;
323
-
324
- return from && to && status ? [from, { to, status }] : undefined;
325
- })
326
- .filter((rule) => rule !== undefined) as [
327
- string,
328
- { to: string; status?: number }
329
- ][]
330
- );
331
-
332
- const rulesMatcher = generateRulesMatcher(
333
- rules,
334
- ({ status, to }, replacements) => ({
335
- status,
336
- to: replacer(to, replacements),
337
- })
338
- );
339
-
340
- return (request: Request) => {
341
- const match = rulesMatcher({
342
- request,
343
- })[0];
344
- if (match) return match;
345
- };
346
- } else {
347
- return () => undefined;
348
- }
349
- }
350
-
351
- function extractPathname(
352
- path = "/",
353
- includeSearch: boolean,
354
- includeHash: boolean
355
- ) {
356
- if (!path.startsWith("/")) path = `/${path}`;
357
- const url = new URL(`//${path}`, "relative://");
358
- return `${url.pathname}${includeSearch ? url.search : ""}${
359
- includeHash ? url.hash : ""
360
- }`;
361
- }
362
-
363
- function validateURL(
364
- token: string,
365
- onlyRelative = false,
366
- includeSearch = false,
367
- includeHash = false
368
- ) {
369
- const host = /^https:\/\/+(?<host>[^/]+)\/?(?<path>.*)/.exec(token);
370
- if (host && host.groups && host.groups.host) {
371
- if (onlyRelative) return;
372
-
373
- return `https://${host.groups.host}${extractPathname(
374
- host.groups.path,
375
- includeSearch,
376
- includeHash
377
- )}`;
378
- } else {
379
- if (!token.startsWith("/") && onlyRelative) token = `/${token}`;
380
-
381
- const path = /^\//.exec(token);
382
- if (path) {
383
- try {
384
- return extractPathname(token, includeSearch, includeHash);
385
- } catch {}
386
- }
387
- }
388
- return "";
389
- }
390
-
391
- function hasFileExtension(pathname: string) {
392
- return /\/.+\.[a-z0-9]+$/i.test(pathname);
393
- }
394
-
395
- async function generateAssetsFetch(directory: string): Promise<typeof fetch> {
396
- // Defer importing miniflare until we really need it
397
- const { Headers, Request, Response } = await import("@miniflare/core");
398
-
399
- const headersFile = join(directory, "_headers");
400
- const redirectsFile = join(directory, "_redirects");
401
- const workerFile = join(directory, "_worker.js");
402
-
403
- const ignoredFiles = [headersFile, redirectsFile, workerFile];
404
-
405
- const assetExists = (path: string) => {
406
- path = join(directory, path);
407
- return (
408
- existsSync(path) &&
409
- lstatSync(path).isFile() &&
410
- !ignoredFiles.includes(path)
411
- );
412
- };
413
-
414
- const getAsset = (path: string) => {
415
- if (assetExists(path)) {
416
- return join(directory, path);
417
- }
418
- };
419
-
420
- let redirectsMatcher = generateRedirectsMatcher(redirectsFile);
421
- let headersMatcher = generateHeadersMatcher(headersFile);
422
-
423
- watch([headersFile, redirectsFile], {
424
- persistent: true,
425
- }).on("change", (path) => {
426
- switch (path) {
427
- case headersFile: {
428
- console.log("_headers modified. Re-evaluating...");
429
- headersMatcher = generateHeadersMatcher(headersFile);
430
- break;
431
- }
432
- case redirectsFile: {
433
- console.log("_redirects modified. Re-evaluating...");
434
- redirectsMatcher = generateRedirectsMatcher(redirectsFile);
435
- break;
436
- }
437
- }
438
- });
439
-
440
- const serveAsset = (file: string) => {
441
- return readFileSync(file);
442
- };
443
-
444
- const generateResponse = (request: Request) => {
445
- const url = new URL(request.url);
446
-
447
- const deconstructedResponse: {
448
- status: number;
449
- headers: Headers;
450
- body?: Buffer;
451
- } = {
452
- status: 200,
453
- headers: new Headers(),
454
- body: undefined,
455
- };
456
-
457
- const match = redirectsMatcher(request);
458
- if (match) {
459
- const { status, to } = match;
460
-
461
- let location = to;
462
- let search;
463
-
464
- if (to.startsWith("/")) {
465
- search = new URL(location, "http://fakehost").search;
466
- } else {
467
- search = new URL(location).search;
468
- }
469
-
470
- location = `${location}${search ? "" : url.search}`;
471
-
472
- if (status && [301, 302, 303, 307, 308].includes(status)) {
473
- deconstructedResponse.status = status;
474
- } else {
475
- deconstructedResponse.status = 302;
476
- }
477
-
478
- deconstructedResponse.headers.set("Location", location);
479
- return deconstructedResponse;
480
- }
481
-
482
- if (!request.method?.match(/^(get|head)$/i)) {
483
- deconstructedResponse.status = 405;
484
- return deconstructedResponse;
485
- }
486
-
487
- const notFound = () => {
488
- let cwd = url.pathname;
489
- while (cwd) {
490
- cwd = cwd.slice(0, cwd.lastIndexOf("/"));
491
-
492
- if ((asset = getAsset(`${cwd}/404.html`))) {
493
- deconstructedResponse.status = 404;
494
- deconstructedResponse.body = serveAsset(asset);
495
- deconstructedResponse.headers.set(
496
- "Content-Type",
497
- getType(asset) || "application/octet-stream"
498
- );
499
- return deconstructedResponse;
500
- }
501
- }
502
-
503
- if ((asset = getAsset(`/index.html`))) {
504
- deconstructedResponse.body = serveAsset(asset);
505
- deconstructedResponse.headers.set(
506
- "Content-Type",
507
- getType(asset) || "application/octet-stream"
508
- );
509
- return deconstructedResponse;
510
- }
511
-
512
- deconstructedResponse.status = 404;
513
- return deconstructedResponse;
514
- };
515
-
516
- let asset;
517
-
518
- if (url.pathname.endsWith("/")) {
519
- if ((asset = getAsset(`${url.pathname}/index.html`))) {
520
- deconstructedResponse.body = serveAsset(asset);
521
- deconstructedResponse.headers.set(
522
- "Content-Type",
523
- getType(asset) || "application/octet-stream"
524
- );
525
- return deconstructedResponse;
526
- } else if (
527
- (asset = getAsset(`${url.pathname.replace(/\/$/, ".html")}`))
528
- ) {
529
- deconstructedResponse.status = 301;
530
- deconstructedResponse.headers.set(
531
- "Location",
532
- `${url.pathname.slice(0, -1)}${url.search}`
533
- );
534
- return deconstructedResponse;
535
- }
536
- }
537
-
538
- if (url.pathname.endsWith("/index")) {
539
- deconstructedResponse.status = 301;
540
- deconstructedResponse.headers.set(
541
- "Location",
542
- `${url.pathname.slice(0, -"index".length)}${url.search}`
543
- );
544
- return deconstructedResponse;
545
- }
546
-
547
- if ((asset = getAsset(url.pathname))) {
548
- if (url.pathname.endsWith(".html")) {
549
- const extensionlessPath = url.pathname.slice(0, -".html".length);
550
- if (getAsset(extensionlessPath) || extensionlessPath === "/") {
551
- deconstructedResponse.body = serveAsset(asset);
552
- deconstructedResponse.headers.set(
553
- "Content-Type",
554
- getType(asset) || "application/octet-stream"
555
- );
556
- return deconstructedResponse;
557
- } else {
558
- deconstructedResponse.status = 301;
559
- deconstructedResponse.headers.set(
560
- "Location",
561
- `${extensionlessPath}${url.search}`
562
- );
563
- return deconstructedResponse;
564
- }
565
- } else {
566
- deconstructedResponse.body = serveAsset(asset);
567
- deconstructedResponse.headers.set(
568
- "Content-Type",
569
- getType(asset) || "application/octet-stream"
570
- );
571
- return deconstructedResponse;
572
- }
573
- } else if (hasFileExtension(url.pathname)) {
574
- notFound();
575
- return deconstructedResponse;
576
- }
577
-
578
- if ((asset = getAsset(`${url.pathname}.html`))) {
579
- deconstructedResponse.body = serveAsset(asset);
580
- deconstructedResponse.headers.set(
581
- "Content-Type",
582
- getType(asset) || "application/octet-stream"
583
- );
584
- return deconstructedResponse;
585
- }
586
-
587
- if ((asset = getAsset(`${url.pathname}/index.html`))) {
588
- deconstructedResponse.status = 301;
589
- deconstructedResponse.headers.set(
590
- "Location",
591
- `${url.pathname}/${url.search}`
592
- );
593
- return deconstructedResponse;
594
- } else {
595
- notFound();
596
- return deconstructedResponse;
597
- }
598
- };
599
-
600
- const attachHeaders = (
601
- request: Request,
602
- deconstructedResponse: { status: number; headers: Headers; body?: Buffer }
603
- ) => {
604
- const headers = deconstructedResponse.headers;
605
- const newHeaders = new Headers({});
606
- const matches = headersMatcher(request) || [];
607
-
608
- matches.forEach((match) => {
609
- Object.entries(match).forEach(([name, value]) => {
610
- newHeaders.append(name, `${value}`);
611
- });
612
- });
613
-
614
- const combinedHeaders = {
615
- ...Object.fromEntries(headers.entries()),
616
- ...Object.fromEntries(newHeaders.entries()),
617
- };
618
-
619
- deconstructedResponse.headers = new Headers({});
620
- Object.entries(combinedHeaders).forEach(([name, value]) => {
621
- if (value) deconstructedResponse.headers.set(name, value);
622
- });
623
- };
624
-
625
- return async (input, init) => {
626
- const request = new Request(input, init);
627
- const deconstructedResponse = generateResponse(request);
628
- attachHeaders(request, deconstructedResponse);
629
-
630
- const headers = new Headers();
631
-
632
- [...deconstructedResponse.headers.entries()].forEach(([name, value]) => {
633
- if (value) headers.set(name, value);
634
- });
635
-
636
- return new Response(deconstructedResponse.body, {
637
- headers,
638
- status: deconstructedResponse.status,
639
- });
640
- };
641
- }
642
-
643
- const RUNNING_BUILDERS: BuildResult[] = [];
644
-
645
- async function buildFunctions({
646
- scriptPath,
647
- outputConfigPath,
648
- functionsDirectory,
649
- minify = false,
650
- sourcemap = false,
651
- fallbackService = "ASSETS",
652
- watch = false,
653
- onEnd,
654
- }: {
655
- scriptPath: string;
656
- outputConfigPath?: string;
657
- functionsDirectory: string;
658
- minify?: boolean;
659
- sourcemap?: boolean;
660
- fallbackService?: string;
661
- watch?: boolean;
662
- onEnd?: () => void;
663
- }) {
664
- RUNNING_BUILDERS.forEach(
665
- (runningBuilder) => runningBuilder.stop && runningBuilder.stop()
666
- );
667
-
668
- const routesModule = join(tmpdir(), "./functionsRoutes.mjs");
669
- const baseURL = toUrlPath("/");
670
-
671
- const config: Config = await generateConfigFromFileTree({
672
- baseDir: functionsDirectory,
673
- baseURL,
674
- });
675
-
676
- if (outputConfigPath) {
677
- writeFileSync(
678
- outputConfigPath,
679
- JSON.stringify({ ...config, baseURL }, null, 2)
680
- );
681
- }
682
-
683
- await writeRoutesModule({
684
- config,
685
- srcDir: functionsDirectory,
686
- outfile: routesModule,
687
- });
688
-
689
- RUNNING_BUILDERS.push(
690
- await buildWorker({
691
- routesModule,
692
- outfile: scriptPath,
693
- minify,
694
- sourcemap,
695
- fallbackService,
696
- watch,
697
- onEnd,
698
- })
699
- );
700
- }
701
-
702
- export const pages: BuilderCallback<unknown, unknown> = (yargs) => {
703
- return yargs
704
- .command(
705
- "dev [directory] [-- command]",
706
- "🧑‍💻 Develop your full-stack Pages application locally",
707
- (yargs) => {
708
- return yargs
709
- .positional("directory", {
710
- type: "string",
711
- demandOption: undefined,
712
- description: "The directory of static assets to serve",
713
- })
714
- .positional("command", {
715
- type: "string",
716
- demandOption: undefined,
717
- description: "The proxy command to run",
718
- })
719
- .options({
720
- local: {
721
- type: "boolean",
722
- default: true,
723
- description: "Run on my machine",
724
- },
725
- port: {
726
- type: "number",
727
- default: 8788,
728
- description: "The port to listen on (serve from)",
729
- },
730
- proxy: {
731
- type: "number",
732
- description:
733
- "The port to proxy (where the static assets are served)",
734
- },
735
- "script-path": {
736
- type: "string",
737
- default: "_worker.js",
738
- description:
739
- "The location of the single Worker script if not using functions",
740
- },
741
- binding: {
742
- type: "array",
743
- description: "Bind variable/secret (KEY=VALUE)",
744
- alias: "b",
745
- },
746
- kv: {
747
- type: "array",
748
- description: "KV namespace to bind",
749
- alias: "k",
750
- },
751
- do: {
752
- type: "array",
753
- description: "Durable Object to bind (NAME=CLASS)",
754
- alias: "o",
755
- },
756
- "live-reload": {
757
- type: "boolean",
758
- default: false,
759
- description: "Auto reload HTML pages when change is detected",
760
- },
761
- // TODO: Miniflare user options
762
- });
763
- },
764
- async ({
765
- local,
766
- directory,
767
- port,
768
- proxy: requestedProxyPort,
769
- "script-path": singleWorkerScriptPath,
770
- binding: bindings = [],
771
- kv: kvs = [],
772
- do: durableObjects = [],
773
- "live-reload": liveReload,
774
- _: [_pages, _dev, ...remaining],
775
- }) => {
776
- if (!local) {
777
- console.error("Only local mode is supported at the moment.");
778
- return;
779
- }
780
-
781
- const functionsDirectory = "./functions";
782
- const usingFunctions = existsSync(functionsDirectory);
783
-
784
- const command = remaining as (string | number)[];
785
-
786
- let proxyPort: number | void;
787
-
788
- if (directory === undefined) {
789
- proxyPort = await spawnProxyProcess({
790
- port: requestedProxyPort,
791
- command,
792
- });
793
- if (proxyPort === undefined) return undefined;
794
- }
795
-
796
- let miniflareArgs: MiniflareOptions = {};
797
-
798
- let scriptReadyResolve: () => void;
799
- const scriptReadyPromise = new Promise<void>(
800
- (resolve) => (scriptReadyResolve = resolve)
801
- );
802
-
803
- if (usingFunctions) {
804
- const scriptPath = join(tmpdir(), "./functionsWorker.js");
805
-
806
- console.log(`Compiling worker to "${scriptPath}"...`);
807
-
808
- await buildFunctions({
809
- scriptPath,
810
- functionsDirectory,
811
- sourcemap: true,
812
- watch: true,
813
- onEnd: () => scriptReadyResolve(),
814
- });
815
-
816
- watch([functionsDirectory], {
817
- persistent: true,
818
- ignoreInitial: true,
819
- }).on("all", async () => {
820
- await buildFunctions({
821
- scriptPath,
822
- functionsDirectory,
823
- sourcemap: true,
824
- watch: true,
825
- onEnd: () => scriptReadyResolve(),
826
- });
827
- });
828
-
829
- miniflareArgs = {
830
- scriptPath,
831
- };
832
- } else {
833
- // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
834
- scriptReadyResolve!();
835
-
836
- const scriptPath =
837
- directory !== undefined
838
- ? join(directory, singleWorkerScriptPath)
839
- : singleWorkerScriptPath;
840
-
841
- if (existsSync(scriptPath)) {
842
- miniflareArgs = {
843
- scriptPath,
844
- };
845
- } else {
846
- console.log("No functions. Shimming...");
847
- miniflareArgs = {
848
- // TODO: The fact that these request/response hacks are necessary is ridiculous.
849
- // We need to eliminate them from env.ASSETS.fetch (not sure if just local or prod as well)
850
- script: `
851
- export default {
852
- async fetch(request, env, context) {
853
- const response = await env.ASSETS.fetch(request.url, request)
854
- return new Response(response.body, response)
855
- }
856
- }`,
857
- };
858
- }
859
- }
860
-
861
- // Defer importing miniflare until we really need it
862
- const { Miniflare, Log, LogLevel } = await import("miniflare");
863
- const { Response, fetch } = await import("@miniflare/core");
864
-
865
- // Wait for esbuild to finish building before starting Miniflare.
866
- // This must be before the call to `new Miniflare`, as that will
867
- // asynchronously start loading the script. `await startServer()`
868
- // internally just waits for that promise to resolve.
869
- await scriptReadyPromise;
870
-
871
- // `assetsFetch()` will only be called if there is `proxyPort` defined.
872
- // We only define `proxyPort`, above, when there is no `directory` defined.
873
- const assetsFetch =
874
- directory !== undefined
875
- ? await generateAssetsFetch(directory)
876
- : invalidAssetsFetch;
877
-
878
- const miniflare = new Miniflare({
879
- port,
880
- watch: true,
881
- modules: true,
882
-
883
- log: new Log(LogLevel.ERROR, { prefix: "pages" }),
884
- logUnhandledRejections: true,
885
- sourceMap: true,
886
-
887
- kvNamespaces: kvs.map((kv) => kv.toString()),
888
-
889
- durableObjects: Object.fromEntries(
890
- durableObjects.map((durableObject) =>
891
- durableObject.toString().split("=")
892
- )
893
- ),
894
-
895
- // User bindings
896
- bindings: {
897
- ...Object.fromEntries(
898
- bindings.map((binding) => binding.toString().split("=", 1))
899
- ),
900
- },
901
-
902
- // env.ASSETS.fetch
903
- serviceBindings: {
904
- async ASSETS(request: Request) {
905
- if (proxyPort) {
906
- try {
907
- const url = new URL(request.url);
908
- url.host = `localhost:${proxyPort}`;
909
- return await fetch(url, request);
910
- } catch (thrown) {
911
- console.error(`Could not proxy request: ${thrown}`);
912
-
913
- // TODO: Pretty error page
914
- return new Response(
915
- `[wrangler] Could not proxy request: ${thrown}`,
916
- { status: 502 }
917
- );
918
- }
919
- } else {
920
- try {
921
- return await assetsFetch(request);
922
- } catch (thrown) {
923
- console.error(`Could not serve static asset: ${thrown}`);
924
-
925
- // TODO: Pretty error page
926
- return new Response(
927
- `[wrangler] Could not serve static asset: ${thrown}`,
928
- { status: 502 }
929
- );
930
- }
931
- }
932
- },
933
- },
934
-
935
- kvPersist: true,
936
- durableObjectsPersist: true,
937
- cachePersist: true,
938
- liveReload,
939
-
940
- ...miniflareArgs,
941
- });
942
-
943
- try {
944
- // `startServer` might throw if user code contains errors
945
- const server = await miniflare.startServer();
946
- console.log(`Serving at http://localhost:${port}/`);
947
-
948
- if (process.env.BROWSER !== "none") {
949
- await openInBrowser(`http://localhost:${port}/`);
950
- }
951
-
952
- if (directory !== undefined && liveReload) {
953
- watch([directory], {
954
- persistent: true,
955
- ignoreInitial: true,
956
- }).on("all", async () => {
957
- await miniflare.reload();
958
- });
959
- }
960
-
961
- EXIT_CALLBACKS.push(() => {
962
- server.close();
963
- miniflare.dispose().catch((err) => miniflare.log.error(err));
964
- });
965
- } catch (e) {
966
- miniflare.log.error(e as Error);
967
- EXIT("Could not start Miniflare.", 1);
968
- }
969
- }
970
- )
971
- .command("functions", false, (yargs) =>
972
- // we hide this command from help output because
973
- // it's not meant to be used directly right now
974
- yargs.command(
975
- "build [directory]",
976
- "Compile a folder of Cloudflare Pages Functions into a single Worker",
977
- (yargs) =>
978
- yargs
979
- .positional("directory", {
980
- type: "string",
981
- default: "functions",
982
- description: "The directory of Pages Functions",
983
- })
984
- .options({
985
- "script-path": {
986
- type: "string",
987
- default: "_worker.js",
988
- description: "The location of the output Worker script",
989
- },
990
- "output-config-path": {
991
- type: "string",
992
- description: "The location for the output config file",
993
- },
994
- minify: {
995
- type: "boolean",
996
- default: false,
997
- description: "Minify the output Worker script",
998
- },
999
- sourcemap: {
1000
- type: "boolean",
1001
- default: false,
1002
- description:
1003
- "Generate a sourcemap for the output Worker script",
1004
- },
1005
- "fallback-service": {
1006
- type: "string",
1007
- default: "ASSETS",
1008
- description:
1009
- "The service to fallback to at the end of the `next` chain. Setting to '' will fallback to the global `fetch`.",
1010
- },
1011
- watch: {
1012
- type: "boolean",
1013
- default: false,
1014
- description:
1015
- "Watch for changes to the functions and automatically rebuild the Worker script",
1016
- },
1017
- }),
1018
- async ({
1019
- directory,
1020
- "script-path": scriptPath,
1021
- "output-config-path": outputConfigPath,
1022
- minify,
1023
- sourcemap,
1024
- fallbackService,
1025
- watch,
1026
- }) => {
1027
- await buildFunctions({
1028
- scriptPath,
1029
- outputConfigPath,
1030
- functionsDirectory: directory,
1031
- minify,
1032
- sourcemap,
1033
- fallbackService,
1034
- watch,
1035
- });
1036
- }
1037
- )
1038
- );
1039
- };
1040
-
1041
- const invalidAssetsFetch: typeof fetch = () => {
1042
- throw new Error(
1043
- "Trying to fetch assets directly when there is no `directory` option specified, and not in `local` mode."
1044
- );
1045
- };