wrangler 0.0.0-eebdb6c → 0.0.0-eec88346

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 (304) hide show
  1. package/Cloudflare_CA.pem +18 -0
  2. package/README.md +47 -14
  3. package/bin/wrangler.js +160 -28
  4. package/kv-asset-handler.js +1 -0
  5. package/miniflare-dist/index.mjs +6314 -0
  6. package/package.json +190 -122
  7. package/src/__tests__/access.test.ts +25 -0
  8. package/src/__tests__/api-dev.test.ts +209 -0
  9. package/src/__tests__/api-devregistry.test.js +56 -0
  10. package/src/__tests__/api.test.ts +80 -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 +3972 -0
  14. package/src/__tests__/d1.test.ts +72 -0
  15. package/src/__tests__/delete.test.ts +230 -0
  16. package/src/__tests__/deployments.test.ts +91 -0
  17. package/src/__tests__/dev.test.tsx +1455 -0
  18. package/src/__tests__/dialogs.test.tsx +40 -0
  19. package/src/__tests__/generate.test.ts +235 -0
  20. package/src/__tests__/get-host-from-url.test.ts +16 -0
  21. package/src/__tests__/guess-worker-format.test.ts +85 -0
  22. package/src/__tests__/{clipboardy-mock.js → helpers/clipboardy-mock.js} +0 -0
  23. package/src/__tests__/helpers/cmd-shim.d.ts +11 -0
  24. package/src/__tests__/helpers/mock-account-id.ts +48 -0
  25. package/src/__tests__/helpers/mock-bin.ts +36 -0
  26. package/src/__tests__/helpers/mock-cfetch.ts +333 -0
  27. package/src/__tests__/helpers/mock-console.ts +106 -0
  28. package/src/__tests__/helpers/mock-dialogs.ts +153 -0
  29. package/src/__tests__/helpers/mock-get-zone-from-host.ts +8 -0
  30. package/src/__tests__/helpers/mock-http-server.ts +46 -0
  31. package/src/__tests__/helpers/mock-istty.ts +74 -0
  32. package/src/__tests__/helpers/mock-known-routes.ts +7 -0
  33. package/src/__tests__/helpers/mock-kv.ts +33 -0
  34. package/src/__tests__/helpers/mock-oauth-flow.ts +252 -0
  35. package/src/__tests__/helpers/mock-process.ts +39 -0
  36. package/src/__tests__/helpers/mock-stdin.ts +108 -0
  37. package/src/__tests__/helpers/mock-web-socket.ts +29 -0
  38. package/src/__tests__/helpers/msw/handlers/access.ts +13 -0
  39. package/src/__tests__/helpers/msw/handlers/deployments.ts +86 -0
  40. package/src/__tests__/helpers/msw/handlers/namespaces.ts +104 -0
  41. package/src/__tests__/helpers/msw/handlers/oauth.ts +36 -0
  42. package/src/__tests__/helpers/msw/handlers/r2.ts +80 -0
  43. package/src/__tests__/helpers/msw/handlers/script.ts +75 -0
  44. package/src/__tests__/helpers/msw/handlers/user.ts +63 -0
  45. package/src/__tests__/helpers/msw/handlers/zones.ts +22 -0
  46. package/src/__tests__/helpers/msw/index.ts +21 -0
  47. package/src/__tests__/helpers/run-in-tmp.ts +38 -0
  48. package/src/__tests__/helpers/run-wrangler.ts +16 -0
  49. package/src/__tests__/helpers/worker-scripts/child-wrangler.toml +1 -0
  50. package/src/__tests__/helpers/worker-scripts/hello-world-worker.js +5 -0
  51. package/src/__tests__/helpers/worker-scripts/hello-world-wrangler.toml +1 -0
  52. package/src/__tests__/helpers/worker-scripts/parent-worker.js +8 -0
  53. package/src/__tests__/helpers/worker-scripts/parent-wrangler.toml +5 -0
  54. package/src/__tests__/helpers/write-worker-source.ts +31 -0
  55. package/src/__tests__/helpers/write-wrangler-toml.ts +17 -0
  56. package/src/__tests__/https-options.test.ts +163 -0
  57. package/src/__tests__/index.test.ts +252 -284
  58. package/src/__tests__/init.test.ts +2900 -0
  59. package/src/__tests__/jest.setup.ts +190 -10
  60. package/src/__tests__/kv.test.ts +1463 -886
  61. package/src/__tests__/logger.test.ts +141 -0
  62. package/src/__tests__/metrics.test.ts +450 -0
  63. package/src/__tests__/middleware.scheduled.test.ts +135 -0
  64. package/src/__tests__/middleware.test.ts +726 -0
  65. package/src/__tests__/package-manager.test.ts +353 -0
  66. package/src/__tests__/pages.test.ts +2221 -0
  67. package/src/__tests__/parse.test.ts +330 -0
  68. package/src/__tests__/paths.test.ts +39 -0
  69. package/src/__tests__/publish.test.ts +7282 -0
  70. package/src/__tests__/pubsub.test.ts +367 -0
  71. package/src/__tests__/queues.test.ts +368 -0
  72. package/src/__tests__/r2.test.ts +371 -0
  73. package/src/__tests__/route.test.ts +45 -0
  74. package/src/__tests__/secret.test.ts +644 -0
  75. package/src/__tests__/tail.test.ts +800 -0
  76. package/src/__tests__/test-old-node-version.js +31 -0
  77. package/src/__tests__/type-generation.test.ts +217 -0
  78. package/src/__tests__/user.test.ts +155 -0
  79. package/src/__tests__/utils-collectKeyValues.test.ts +47 -0
  80. package/src/__tests__/validate-dev-props.test.ts +56 -0
  81. package/src/__tests__/version.test.ts +35 -0
  82. package/src/__tests__/whoami.test.tsx +278 -0
  83. package/src/__tests__/worker-namespace.test.ts +321 -0
  84. package/src/abort.d.ts +3 -0
  85. package/src/api/dev.ts +208 -0
  86. package/src/api/index.ts +2 -0
  87. package/src/bundle-reporter.tsx +29 -0
  88. package/src/bundle.ts +782 -0
  89. package/src/cfetch/index.ts +128 -71
  90. package/src/cfetch/internal.ts +240 -46
  91. package/src/cli.ts +26 -6
  92. package/src/config/README.md +107 -0
  93. package/src/config/config.ts +275 -0
  94. package/src/config/diagnostics.ts +80 -0
  95. package/src/config/environment.ts +549 -0
  96. package/src/config/index.ts +306 -0
  97. package/src/config/validation-helpers.ts +597 -0
  98. package/src/config/validation.ts +2095 -0
  99. package/src/config-cache.ts +85 -0
  100. package/src/create-worker-preview.ts +282 -0
  101. package/src/create-worker-upload-form.ts +314 -0
  102. package/src/d1/backups.tsx +218 -0
  103. package/src/d1/constants.ts +2 -0
  104. package/src/d1/create.tsx +54 -0
  105. package/src/d1/delete.tsx +56 -0
  106. package/src/d1/execute.tsx +334 -0
  107. package/src/d1/formatTimeAgo.ts +14 -0
  108. package/src/d1/index.ts +98 -0
  109. package/src/d1/list.tsx +48 -0
  110. package/src/d1/migrations.tsx +446 -0
  111. package/src/d1/options.ts +22 -0
  112. package/src/d1/types.tsx +24 -0
  113. package/src/d1/utils.ts +48 -0
  114. package/src/delete.ts +111 -0
  115. package/src/deprecated/index.ts +453 -0
  116. package/src/dev/dev-vars.ts +36 -0
  117. package/src/dev/dev.tsx +587 -0
  118. package/src/dev/get-local-persistence-path.tsx +31 -0
  119. package/src/dev/local.tsx +717 -0
  120. package/src/dev/remote.tsx +602 -0
  121. package/src/dev/start-server.ts +516 -0
  122. package/src/dev/use-esbuild.ts +200 -0
  123. package/src/dev/validate-dev-props.ts +31 -0
  124. package/src/dev-registry.tsx +201 -0
  125. package/src/dev.tsx +850 -857
  126. package/src/dialogs.tsx +153 -61
  127. package/src/dispatch-namespace.ts +206 -0
  128. package/src/durable.ts +102 -0
  129. package/src/entry.ts +329 -0
  130. package/src/environment-variables.ts +50 -0
  131. package/src/errors.ts +11 -0
  132. package/src/git-client.ts +124 -0
  133. package/src/global-wrangler-config-path.ts +26 -0
  134. package/src/https-options.ts +127 -0
  135. package/src/index.tsx +663 -1889
  136. package/src/init.ts +969 -0
  137. package/src/inspect.ts +767 -0
  138. package/src/intl-polyfill.d.ts +139 -0
  139. package/src/is-ci.ts +14 -0
  140. package/src/is-interactive.ts +16 -0
  141. package/src/kv/helpers.ts +430 -0
  142. package/src/kv/index.ts +645 -0
  143. package/src/logger.ts +92 -0
  144. package/src/metrics/index.ts +5 -0
  145. package/src/metrics/metrics-config.ts +239 -0
  146. package/src/metrics/metrics-dispatcher.ts +96 -0
  147. package/src/metrics/metrics-usage-headers.ts +24 -0
  148. package/src/metrics/send-event.ts +94 -0
  149. package/src/miniflare-cli/README.md +30 -0
  150. package/src/miniflare-cli/assets.ts +215 -0
  151. package/src/miniflare-cli/index.ts +213 -0
  152. package/src/miniflare-cli/request-context.ts +40 -0
  153. package/src/module-collection.ts +256 -53
  154. package/src/open-in-browser.ts +17 -0
  155. package/src/package-manager.ts +219 -0
  156. package/src/pages/build.tsx +238 -0
  157. package/src/pages/constants.ts +18 -0
  158. package/src/pages/deployments.tsx +106 -0
  159. package/src/pages/dev.tsx +693 -0
  160. package/src/pages/errors.ts +66 -0
  161. package/src/pages/functions/buildPlugin.ts +110 -0
  162. package/src/pages/functions/buildWorker.ts +156 -0
  163. package/src/pages/functions/filepath-routing.test.ts +234 -0
  164. package/src/pages/functions/filepath-routing.ts +189 -0
  165. package/src/pages/functions/identifiers.ts +78 -0
  166. package/src/pages/functions/routes-consolidation.test.ts +250 -0
  167. package/src/pages/functions/routes-consolidation.ts +73 -0
  168. package/src/pages/functions/routes-transformation.test.ts +282 -0
  169. package/src/pages/functions/routes-transformation.ts +115 -0
  170. package/src/pages/functions/routes-validation.test.ts +403 -0
  171. package/src/pages/functions/routes-validation.ts +202 -0
  172. package/src/pages/functions/routes.ts +151 -0
  173. package/src/pages/functions.tsx +82 -0
  174. package/src/pages/hash.tsx +13 -0
  175. package/src/pages/index.tsx +94 -0
  176. package/src/pages/projects.tsx +169 -0
  177. package/src/pages/publish.tsx +436 -0
  178. package/src/pages/types.ts +49 -0
  179. package/src/pages/upload.tsx +425 -0
  180. package/src/pages/utils.ts +12 -0
  181. package/src/parse.ts +286 -0
  182. package/src/paths.ts +71 -0
  183. package/src/proxy.ts +678 -92
  184. package/src/publish/index.ts +267 -0
  185. package/src/publish/publish.ts +976 -0
  186. package/src/pubsub/index.ts +286 -0
  187. package/src/pubsub/pubsub-commands.tsx +623 -0
  188. package/src/queues/cli/commands/consumer/add.ts +75 -0
  189. package/src/queues/cli/commands/consumer/index.ts +19 -0
  190. package/src/queues/cli/commands/consumer/remove.ts +44 -0
  191. package/src/queues/cli/commands/create.ts +25 -0
  192. package/src/queues/cli/commands/delete.ts +26 -0
  193. package/src/queues/cli/commands/index.ts +32 -0
  194. package/src/queues/cli/commands/list.ts +25 -0
  195. package/src/queues/client.ts +135 -0
  196. package/src/r2/helpers.ts +131 -0
  197. package/src/r2/index.ts +277 -0
  198. package/src/routes.ts +140 -0
  199. package/src/secret/index.ts +404 -0
  200. package/src/selfsigned.d.ts +29 -0
  201. package/src/sites.tsx +357 -99
  202. package/src/tail/createTail.ts +315 -0
  203. package/src/tail/filters.ts +277 -0
  204. package/src/tail/index.ts +217 -0
  205. package/src/tail/printing.ts +107 -0
  206. package/src/type-generation.ts +159 -0
  207. package/src/update-check.ts +19 -0
  208. package/src/user/access.ts +69 -0
  209. package/src/user/choose-account.tsx +69 -0
  210. package/src/user/env-vars.ts +46 -0
  211. package/src/user/generate-auth-url.ts +33 -0
  212. package/src/user/generate-random-state.ts +16 -0
  213. package/src/user/index.ts +3 -0
  214. package/src/user/user.tsx +1192 -0
  215. package/src/utils/collectKeyValues.ts +14 -0
  216. package/src/whoami.tsx +169 -0
  217. package/src/worker.ts +243 -0
  218. package/src/yargs-types.ts +7 -0
  219. package/src/zones.ts +191 -0
  220. package/templates/__tests__/pages-dev-util.test.ts +128 -0
  221. package/templates/checked-fetch.js +17 -0
  222. package/templates/d1-beta-facade.js +185 -0
  223. package/templates/experimental-local-cache-stubs.js +27 -0
  224. package/templates/first-party-worker-module-facade.ts +18 -0
  225. package/templates/format-dev-errors.ts +32 -0
  226. package/templates/gitignore +171 -0
  227. package/templates/init-tests/test-jest-new-worker.js +25 -0
  228. package/templates/init-tests/test-vitest-new-worker.js +26 -0
  229. package/templates/middleware/common.ts +62 -0
  230. package/templates/middleware/loader-modules.ts +84 -0
  231. package/templates/middleware/loader-sw.ts +213 -0
  232. package/templates/middleware/middleware-pretty-error.ts +40 -0
  233. package/templates/middleware/middleware-scheduled.ts +15 -0
  234. package/templates/new-worker-scheduled.js +17 -0
  235. package/templates/new-worker-scheduled.ts +32 -0
  236. package/templates/new-worker.js +15 -0
  237. package/templates/new-worker.ts +30 -0
  238. package/templates/no-op-worker.js +10 -0
  239. package/templates/pages-dev-pipeline.ts +28 -0
  240. package/templates/pages-dev-util.ts +52 -0
  241. package/templates/pages-shim.ts +9 -0
  242. package/templates/pages-template-plugin.ts +171 -0
  243. package/templates/pages-template-worker.ts +189 -0
  244. package/templates/serve-static-assets.ts +63 -0
  245. package/templates/service-bindings-module-facade.js +54 -0
  246. package/templates/service-bindings-sw-facade.js +42 -0
  247. package/templates/tsconfig.json +106 -0
  248. package/wrangler-dist/cli.d.ts +880 -0
  249. package/wrangler-dist/cli.js +144775 -105026
  250. package/pages/functions/buildWorker.ts +0 -57
  251. package/pages/functions/filepath-routing.test.ts +0 -32
  252. package/pages/functions/filepath-routing.ts +0 -225
  253. package/pages/functions/identifiers.ts +0 -78
  254. package/pages/functions/routes.ts +0 -158
  255. package/pages/functions/template-worker.ts +0 -135
  256. package/src/__tests__/mock-cfetch.ts +0 -171
  257. package/src/__tests__/mock-dialogs.ts +0 -65
  258. package/src/__tests__/run-in-tmp.ts +0 -19
  259. package/src/__tests__/run-wrangler.ts +0 -32
  260. package/src/api/form_data.ts +0 -131
  261. package/src/api/inspect.ts +0 -430
  262. package/src/api/preview.ts +0 -128
  263. package/src/api/worker.ts +0 -155
  264. package/src/config.ts +0 -131
  265. package/src/kv.tsx +0 -267
  266. package/src/pages.tsx +0 -921
  267. package/src/publish.ts +0 -350
  268. package/src/tail.tsx +0 -73
  269. package/src/user.tsx +0 -1022
  270. package/static-asset-facade.js +0 -47
  271. package/vendor/@cloudflare/kv-asset-handler/CHANGELOG.md +0 -332
  272. package/vendor/@cloudflare/kv-asset-handler/LICENSE_APACHE +0 -176
  273. package/vendor/@cloudflare/kv-asset-handler/LICENSE_MIT +0 -25
  274. package/vendor/@cloudflare/kv-asset-handler/README.md +0 -245
  275. package/vendor/@cloudflare/kv-asset-handler/dist/index.d.ts +0 -32
  276. package/vendor/@cloudflare/kv-asset-handler/dist/index.js +0 -354
  277. package/vendor/@cloudflare/kv-asset-handler/dist/mocks.d.ts +0 -13
  278. package/vendor/@cloudflare/kv-asset-handler/dist/mocks.js +0 -148
  279. package/vendor/@cloudflare/kv-asset-handler/dist/test/getAssetFromKV.d.ts +0 -1
  280. package/vendor/@cloudflare/kv-asset-handler/dist/test/getAssetFromKV.js +0 -436
  281. package/vendor/@cloudflare/kv-asset-handler/dist/test/mapRequestToAsset.d.ts +0 -1
  282. package/vendor/@cloudflare/kv-asset-handler/dist/test/mapRequestToAsset.js +0 -40
  283. package/vendor/@cloudflare/kv-asset-handler/dist/test/serveSinglePageApp.d.ts +0 -1
  284. package/vendor/@cloudflare/kv-asset-handler/dist/test/serveSinglePageApp.js +0 -42
  285. package/vendor/@cloudflare/kv-asset-handler/dist/types.d.ts +0 -26
  286. package/vendor/@cloudflare/kv-asset-handler/dist/types.js +0 -31
  287. package/vendor/@cloudflare/kv-asset-handler/package.json +0 -52
  288. package/vendor/@cloudflare/kv-asset-handler/src/index.ts +0 -296
  289. package/vendor/@cloudflare/kv-asset-handler/src/mocks.ts +0 -136
  290. package/vendor/@cloudflare/kv-asset-handler/src/test/getAssetFromKV.ts +0 -464
  291. package/vendor/@cloudflare/kv-asset-handler/src/test/mapRequestToAsset.ts +0 -33
  292. package/vendor/@cloudflare/kv-asset-handler/src/test/serveSinglePageApp.ts +0 -42
  293. package/vendor/@cloudflare/kv-asset-handler/src/types.ts +0 -39
  294. package/vendor/wrangler-mime/CHANGELOG.md +0 -289
  295. package/vendor/wrangler-mime/LICENSE +0 -21
  296. package/vendor/wrangler-mime/Mime.js +0 -97
  297. package/vendor/wrangler-mime/README.md +0 -187
  298. package/vendor/wrangler-mime/cli.js +0 -46
  299. package/vendor/wrangler-mime/index.js +0 -4
  300. package/vendor/wrangler-mime/lite.js +0 -4
  301. package/vendor/wrangler-mime/package.json +0 -52
  302. package/vendor/wrangler-mime/types/other.js +0 -1
  303. package/vendor/wrangler-mime/types/standard.js +0 -1
  304. package/wrangler-dist/cli.js.map +0 -7
@@ -0,0 +1,516 @@
1
+ import { fork } from "node:child_process";
2
+ import { realpathSync } from "node:fs";
3
+ import { writeFile } from "node:fs/promises";
4
+ import * as path from "node:path";
5
+ import * as util from "node:util";
6
+ import onExit from "signal-exit";
7
+ import tmp from "tmp-promise";
8
+ import { bundleWorker } from "../bundle";
9
+ import {
10
+ getBoundRegisteredWorkers,
11
+ registerWorker,
12
+ startWorkerRegistry,
13
+ stopWorkerRegistry,
14
+ } from "../dev-registry";
15
+ import { runCustomBuild } from "../entry";
16
+ import { logger } from "../logger";
17
+ import { waitForPortToBeAvailable } from "../proxy";
18
+ import {
19
+ setupBindings,
20
+ setupExperimentalLocal,
21
+ setupMiniflareOptions,
22
+ setupNodeOptions,
23
+ } from "./local";
24
+ import { startRemoteServer } from "./remote";
25
+ import { validateDevProps } from "./validate-dev-props";
26
+
27
+ import type { Config } from "../config";
28
+ import type { WorkerRegistry } from "../dev-registry";
29
+ import type { Entry } from "../entry";
30
+ import type { DevProps, DirectorySyncResult } from "./dev";
31
+ import type { LocalProps } from "./local";
32
+ import type { EsbuildBundle } from "./use-esbuild";
33
+ import type { Miniflare as Miniflare3Type } from "@miniflare/tre";
34
+ import type { MiniflareOptions } from "miniflare";
35
+
36
+ import type { ChildProcess } from "node:child_process";
37
+
38
+ export async function startDevServer(
39
+ props: DevProps & {
40
+ local: boolean;
41
+ }
42
+ ) {
43
+ try {
44
+ let workerDefinitions: WorkerRegistry = {};
45
+ validateDevProps(props);
46
+
47
+ if (props.build.command) {
48
+ const relativeFile =
49
+ path.relative(props.entry.directory, props.entry.file) || ".";
50
+ await runCustomBuild(props.entry.file, relativeFile, props.build).catch(
51
+ (err) => {
52
+ logger.error("Custom build failed:", err);
53
+ }
54
+ );
55
+ }
56
+
57
+ //implement a react-free version of useTmpDir
58
+ const directory = setupTempDir();
59
+ if (!directory) {
60
+ throw new Error("Failed to create temporary directory.");
61
+ }
62
+
63
+ //start the worker registry
64
+ startWorkerRegistry().catch((err) => {
65
+ logger.error("failed to start worker registry", err);
66
+ });
67
+ if (props.local) {
68
+ const boundRegisteredWorkers = await getBoundRegisteredWorkers({
69
+ services: props.bindings.services,
70
+ durableObjects: props.bindings.durable_objects,
71
+ });
72
+
73
+ if (!util.isDeepStrictEqual(boundRegisteredWorkers, workerDefinitions)) {
74
+ workerDefinitions = boundRegisteredWorkers || {};
75
+ }
76
+ }
77
+
78
+ const betaD1Shims = props.bindings.d1_databases?.map((db) => db.binding);
79
+
80
+ //implement a react-free version of useEsbuild
81
+ const bundle = await runEsbuild({
82
+ entry: props.entry,
83
+ destination: directory.name,
84
+ jsxFactory: props.jsxFactory,
85
+ rules: props.rules,
86
+ jsxFragment: props.jsxFragment,
87
+ serveAssetsFromWorker: Boolean(
88
+ props.assetPaths && !props.isWorkersSite && props.local
89
+ ),
90
+ tsconfig: props.tsconfig,
91
+ minify: props.minify,
92
+ nodeCompat: props.nodeCompat,
93
+ define: props.define,
94
+ noBundle: props.noBundle,
95
+ assets: props.assetsConfig,
96
+ betaD1Shims,
97
+ workerDefinitions,
98
+ services: props.bindings.services,
99
+ firstPartyWorkerDevFacade: props.firstPartyWorker,
100
+ testScheduled: props.testScheduled,
101
+ experimentalLocalStubCache: props.experimentalLocal,
102
+ });
103
+
104
+ if (props.local) {
105
+ const { stop, inspectorUrl } = await startLocalServer({
106
+ name: props.name,
107
+ bundle: bundle,
108
+ format: props.entry.format,
109
+ compatibilityDate: props.compatibilityDate,
110
+ compatibilityFlags: props.compatibilityFlags,
111
+ bindings: props.bindings,
112
+ assetPaths: props.assetPaths,
113
+ port: props.port,
114
+ ip: props.ip,
115
+ rules: props.rules,
116
+ inspectorPort: props.inspectorPort,
117
+ localPersistencePath: props.localPersistencePath,
118
+ liveReload: props.liveReload,
119
+ crons: props.crons,
120
+ queueConsumers: props.queueConsumers,
121
+ localProtocol: props.localProtocol,
122
+ localUpstream: props.localUpstream,
123
+ logPrefix: props.logPrefix,
124
+ inspect: props.inspect,
125
+ onReady: props.onReady,
126
+ enablePagesAssetsServiceBinding: props.enablePagesAssetsServiceBinding,
127
+ usageModel: props.usageModel,
128
+ workerDefinitions,
129
+ experimentalLocal: props.experimentalLocal,
130
+ });
131
+
132
+ return {
133
+ stop: async () => {
134
+ stop();
135
+ await stopWorkerRegistry();
136
+ },
137
+ inspectorUrl,
138
+ };
139
+ } else {
140
+ const { stop } = await startRemoteServer({
141
+ name: props.name,
142
+ bundle: bundle,
143
+ format: props.entry.format,
144
+ accountId: props.accountId,
145
+ bindings: props.bindings,
146
+ assetPaths: props.assetPaths,
147
+ isWorkersSite: props.isWorkersSite,
148
+ port: props.port,
149
+ ip: props.ip,
150
+ localProtocol: props.localProtocol,
151
+ inspectorPort: props.inspectorPort,
152
+ inspect: props.inspect,
153
+ compatibilityDate: props.compatibilityDate,
154
+ compatibilityFlags: props.compatibilityFlags,
155
+ usageModel: props.usageModel,
156
+ env: props.env,
157
+ legacyEnv: props.legacyEnv,
158
+ zone: props.zone,
159
+ host: props.host,
160
+ routes: props.routes,
161
+ onReady: props.onReady,
162
+ sourceMapPath: bundle?.sourceMapPath,
163
+ sendMetrics: props.sendMetrics,
164
+ });
165
+ return {
166
+ stop: async () => {
167
+ stop();
168
+ await stopWorkerRegistry();
169
+ },
170
+ // TODO: inspectorUrl,
171
+ };
172
+ }
173
+ } catch (err) {
174
+ logger.error(err);
175
+ }
176
+ }
177
+
178
+ function setupTempDir(): DirectorySyncResult | undefined {
179
+ let dir: DirectorySyncResult | undefined;
180
+ try {
181
+ dir = tmp.dirSync({ unsafeCleanup: true });
182
+
183
+ return dir;
184
+ } catch (err) {
185
+ logger.error("Failed to create temporary directory to store built files.");
186
+ }
187
+ }
188
+
189
+ async function runEsbuild({
190
+ entry,
191
+ destination,
192
+ jsxFactory,
193
+ jsxFragment,
194
+ rules,
195
+ assets,
196
+ betaD1Shims,
197
+ serveAssetsFromWorker,
198
+ tsconfig,
199
+ minify,
200
+ nodeCompat,
201
+ define,
202
+ noBundle,
203
+ workerDefinitions,
204
+ services,
205
+ firstPartyWorkerDevFacade,
206
+ testScheduled,
207
+ experimentalLocalStubCache,
208
+ }: {
209
+ entry: Entry;
210
+ destination: string | undefined;
211
+ jsxFactory: string | undefined;
212
+ jsxFragment: string | undefined;
213
+ rules: Config["rules"];
214
+ assets: Config["assets"];
215
+ betaD1Shims?: string[];
216
+ define: Config["define"];
217
+ services: Config["services"];
218
+ serveAssetsFromWorker: boolean;
219
+ tsconfig: string | undefined;
220
+ minify: boolean | undefined;
221
+ nodeCompat: boolean | undefined;
222
+ noBundle: boolean;
223
+ workerDefinitions: WorkerRegistry;
224
+ firstPartyWorkerDevFacade: boolean | undefined;
225
+ testScheduled?: boolean;
226
+ experimentalLocalStubCache: boolean | undefined;
227
+ }): Promise<EsbuildBundle | undefined> {
228
+ if (!destination) return;
229
+
230
+ const {
231
+ resolvedEntryPointPath,
232
+ bundleType,
233
+ modules,
234
+ sourceMapPath,
235
+ }: Awaited<ReturnType<typeof bundleWorker>> = noBundle
236
+ ? {
237
+ modules: [],
238
+ resolvedEntryPointPath: entry.file,
239
+ bundleType: entry.format === "modules" ? "esm" : "commonjs",
240
+ stop: undefined,
241
+ sourceMapPath: undefined,
242
+ }
243
+ : await bundleWorker(entry, destination, {
244
+ serveAssetsFromWorker,
245
+ jsxFactory,
246
+ jsxFragment,
247
+ rules,
248
+ tsconfig,
249
+ minify,
250
+ nodeCompat,
251
+ define,
252
+ checkFetch: true,
253
+ assets: assets && {
254
+ ...assets,
255
+ // disable the cache in dev
256
+ bypassCache: true,
257
+ },
258
+ betaD1Shims,
259
+ workerDefinitions,
260
+ services,
261
+ firstPartyWorkerDevFacade,
262
+ targetConsumer: "dev", // We are starting a dev server
263
+ local: true,
264
+ testScheduled,
265
+ experimentalLocalStubCache,
266
+ });
267
+
268
+ return {
269
+ id: 0,
270
+ entry,
271
+ path: resolvedEntryPointPath,
272
+ type: bundleType,
273
+ modules,
274
+ sourceMapPath,
275
+ };
276
+ }
277
+
278
+ export async function startLocalServer({
279
+ name: workerName,
280
+ bundle,
281
+ format,
282
+ compatibilityDate,
283
+ compatibilityFlags,
284
+ usageModel,
285
+ bindings,
286
+ workerDefinitions,
287
+ assetPaths,
288
+ port,
289
+ inspectorPort,
290
+ rules,
291
+ localPersistencePath,
292
+ liveReload,
293
+ ip,
294
+ crons,
295
+ queueConsumers,
296
+ localProtocol,
297
+ localUpstream,
298
+ inspect,
299
+ onReady,
300
+ logPrefix,
301
+ enablePagesAssetsServiceBinding,
302
+ experimentalLocal,
303
+ }: LocalProps) {
304
+ let local: ChildProcess | undefined;
305
+ let experimentalLocalRef: Miniflare3Type | undefined;
306
+ let removeSignalExitListener: (() => void) | undefined;
307
+ let inspectorUrl: string | undefined;
308
+ const setInspectorUrl = (url: string) => {
309
+ inspectorUrl = url;
310
+ };
311
+
312
+ const abortController = new AbortController();
313
+ async function startLocalWorker() {
314
+ if (!bundle || !format) return;
315
+
316
+ // port for the worker
317
+
318
+ if (port !== 0) {
319
+ await waitForPortToBeAvailable(port, {
320
+ retryPeriod: 200,
321
+ timeout: 2000,
322
+ abortSignal: abortController.signal,
323
+ });
324
+ }
325
+
326
+ if (bindings.services && bindings.services.length > 0) {
327
+ logger.warn(
328
+ "⎔ Support for service bindings in local mode is experimental and may change."
329
+ );
330
+ }
331
+
332
+ // In local mode, we want to copy all referenced modules into
333
+ // the output bundle directory before starting up
334
+ for (const module of bundle.modules) {
335
+ await writeFile(
336
+ path.join(path.dirname(bundle.path), module.name),
337
+ module.content
338
+ );
339
+ }
340
+
341
+ const scriptPath = realpathSync(bundle.path);
342
+
343
+ const upstream =
344
+ typeof localUpstream === "string"
345
+ ? `${localProtocol}://${localUpstream}`
346
+ : undefined;
347
+
348
+ const {
349
+ externalDurableObjects,
350
+ internalDurableObjects,
351
+ wasmBindings,
352
+ textBlobBindings,
353
+ dataBlobBindings,
354
+ } = setupBindings({
355
+ wasm_modules: bindings.wasm_modules,
356
+ text_blobs: bindings.text_blobs,
357
+ data_blobs: bindings.data_blobs,
358
+ durable_objects: bindings.durable_objects,
359
+ format,
360
+ bundle,
361
+ });
362
+
363
+ const { forkOptions, miniflareCLIPath } = setupMiniflareOptions({
364
+ workerName,
365
+ port,
366
+ scriptPath,
367
+ localProtocol,
368
+ ip,
369
+ format,
370
+ rules,
371
+ compatibilityDate,
372
+ compatibilityFlags,
373
+ usageModel,
374
+ kv_namespaces: bindings?.kv_namespaces,
375
+ queueBindings: bindings?.queues,
376
+ queueConsumers,
377
+ r2_buckets: bindings?.r2_buckets,
378
+ d1_databases: bindings?.d1_databases,
379
+ internalDurableObjects,
380
+ externalDurableObjects,
381
+ localPersistencePath,
382
+ liveReload,
383
+ assetPaths,
384
+ vars: bindings?.vars,
385
+ wasmBindings,
386
+ textBlobBindings,
387
+ dataBlobBindings,
388
+ crons,
389
+ upstream,
390
+ logPrefix,
391
+ workerDefinitions,
392
+ enablePagesAssetsServiceBinding,
393
+ });
394
+
395
+ if (experimentalLocal) {
396
+ // TODO: refactor setupMiniflareOptions so we don't need to parse here
397
+ const mf2Options: MiniflareOptions = JSON.parse(forkOptions[0]);
398
+ const mf = await setupExperimentalLocal(mf2Options, format, bundle);
399
+ const runtimeURL = await mf.ready;
400
+ experimentalLocalRef = mf;
401
+ removeSignalExitListener = onExit((_code, _signal) => {
402
+ logger.log("⎔ Shutting down experimental local server.");
403
+ mf.dispose();
404
+ experimentalLocalRef = undefined;
405
+ });
406
+ onReady?.(runtimeURL.hostname, parseInt(runtimeURL.port ?? 8787));
407
+ return;
408
+ }
409
+
410
+ const nodeOptions = setupNodeOptions({ inspect, ip, inspectorPort });
411
+ logger.log("⎔ Starting a local server...");
412
+
413
+ const child = (local = fork(miniflareCLIPath, forkOptions, {
414
+ cwd: path.dirname(scriptPath),
415
+ execArgv: nodeOptions,
416
+ stdio: "pipe",
417
+ }));
418
+
419
+ child.on("message", async (messageString) => {
420
+ const message = JSON.parse(messageString as string);
421
+ if (message.ready) {
422
+ // Let's register our presence in the dev registry
423
+ if (workerName) {
424
+ await registerWorker(workerName, {
425
+ protocol: localProtocol,
426
+ mode: "local",
427
+ port: message.mfPort,
428
+ host: ip,
429
+ durableObjects: internalDurableObjects.map((binding) => ({
430
+ name: binding.name,
431
+ className: binding.class_name,
432
+ })),
433
+ ...(message.durableObjectsPort
434
+ ? {
435
+ durableObjectsHost: ip,
436
+ durableObjectsPort: message.durableObjectsPort,
437
+ }
438
+ : {}),
439
+ });
440
+ }
441
+ onReady?.(ip, message.mfPort);
442
+ }
443
+ });
444
+
445
+ child.on("close", (code) => {
446
+ if (code) {
447
+ logger.log(`Miniflare process exited with code ${code}`);
448
+ }
449
+ });
450
+
451
+ child.stdout?.on("data", (data: Buffer) => {
452
+ process.stdout.write(data);
453
+ });
454
+
455
+ // parse the node inspector url (which may be received in chunks) from stderr
456
+ let stderrData = "";
457
+ let inspectorUrlFound = false;
458
+ child.stderr?.on("data", (data: Buffer) => {
459
+ if (!inspectorUrlFound) {
460
+ stderrData += data.toString();
461
+ const matches =
462
+ /Debugger listening on (ws:\/\/127\.0\.0\.1:\d+\/[A-Za-z0-9-]+)[\r|\n]/.exec(
463
+ stderrData
464
+ );
465
+ if (matches) {
466
+ inspectorUrlFound = true;
467
+ setInspectorUrl(matches[1]);
468
+ }
469
+ }
470
+
471
+ process.stderr.write(data);
472
+ });
473
+
474
+ child.on("exit", (code) => {
475
+ if (code) {
476
+ logger.error(`Miniflare process exited with code ${code}`);
477
+ }
478
+ });
479
+
480
+ child.on("error", (error: Error) => {
481
+ logger.error(`Miniflare process failed to spawn`);
482
+ logger.error(error);
483
+ });
484
+
485
+ removeSignalExitListener = onExit((_code, _signal) => {
486
+ logger.log("⎔ Shutting down local server.");
487
+ child.kill();
488
+ local = undefined;
489
+ });
490
+ }
491
+
492
+ startLocalWorker().catch((err) => {
493
+ logger.error("local worker:", err);
494
+ });
495
+
496
+ return {
497
+ inspectorUrl,
498
+ stop: () => {
499
+ abortController.abort();
500
+ if (local) {
501
+ logger.log("⎔ Shutting down local server.");
502
+ local.kill();
503
+ local = undefined;
504
+ }
505
+ if (experimentalLocalRef) {
506
+ logger.log("⎔ Shutting down experimental local server.");
507
+ // Initialisation errors are also thrown asynchronously by dispose().
508
+ // The catch() above should've caught them though.
509
+ experimentalLocalRef?.dispose().catch(() => {});
510
+ experimentalLocalRef = undefined;
511
+ }
512
+ removeSignalExitListener?.();
513
+ removeSignalExitListener = undefined;
514
+ },
515
+ };
516
+ }
@@ -0,0 +1,200 @@
1
+ import assert from "node:assert";
2
+ import { watch } from "chokidar";
3
+ import { useApp } from "ink";
4
+ import { useState, useEffect } from "react";
5
+ import { bundleWorker, rewriteNodeCompatBuildFailure } from "../bundle";
6
+ import { logBuildFailure, logger } from "../logger";
7
+ import type { Config } from "../config";
8
+ import type { WorkerRegistry } from "../dev-registry";
9
+ import type { Entry } from "../entry";
10
+ import type { CfModule } from "../worker";
11
+ import type { WatchMode } from "esbuild";
12
+
13
+ export type EsbuildBundle = {
14
+ id: number;
15
+ path: string;
16
+ entry: Entry;
17
+ type: "esm" | "commonjs";
18
+ modules: CfModule[];
19
+ sourceMapPath: string | undefined;
20
+ };
21
+
22
+ export function useEsbuild({
23
+ entry,
24
+ destination,
25
+ jsxFactory,
26
+ jsxFragment,
27
+ rules,
28
+ assets,
29
+ serveAssetsFromWorker,
30
+ tsconfig,
31
+ minify,
32
+ nodeCompat,
33
+ betaD1Shims,
34
+ define,
35
+ noBundle,
36
+ workerDefinitions,
37
+ services,
38
+ durableObjects,
39
+ firstPartyWorkerDevFacade,
40
+ local,
41
+ targetConsumer,
42
+ testScheduled,
43
+ experimentalLocalStubCache,
44
+ }: {
45
+ entry: Entry;
46
+ destination: string | undefined;
47
+ jsxFactory: string | undefined;
48
+ jsxFragment: string | undefined;
49
+ rules: Config["rules"];
50
+ assets: Config["assets"];
51
+ define: Config["define"];
52
+ services: Config["services"];
53
+ serveAssetsFromWorker: boolean;
54
+ tsconfig: string | undefined;
55
+ minify: boolean | undefined;
56
+ nodeCompat: boolean | undefined;
57
+ betaD1Shims?: string[];
58
+ noBundle: boolean;
59
+ workerDefinitions: WorkerRegistry;
60
+ durableObjects: Config["durable_objects"];
61
+ firstPartyWorkerDevFacade: boolean | undefined;
62
+ local: boolean;
63
+ targetConsumer: "dev" | "publish";
64
+ testScheduled: boolean;
65
+ experimentalLocalStubCache: boolean | undefined;
66
+ }): EsbuildBundle | undefined {
67
+ const [bundle, setBundle] = useState<EsbuildBundle>();
68
+ const { exit } = useApp();
69
+ useEffect(() => {
70
+ let stopWatching: (() => void) | undefined = undefined;
71
+
72
+ function updateBundle() {
73
+ // nothing really changes here, so let's increment the id
74
+ // to change the return object's identity
75
+ setBundle((previousBundle) => {
76
+ assert(
77
+ previousBundle,
78
+ "Rebuild triggered with no previous build available"
79
+ );
80
+ return { ...previousBundle, id: previousBundle.id + 1 };
81
+ });
82
+ }
83
+
84
+ const watchMode: WatchMode = {
85
+ async onRebuild(error) {
86
+ if (error !== null) {
87
+ if (!nodeCompat) rewriteNodeCompatBuildFailure(error);
88
+ logBuildFailure(error);
89
+ logger.error("Watch build failed:", error.message);
90
+ } else {
91
+ updateBundle();
92
+ }
93
+ },
94
+ };
95
+
96
+ async function build() {
97
+ if (!destination) return;
98
+
99
+ const {
100
+ resolvedEntryPointPath,
101
+ bundleType,
102
+ modules,
103
+ stop,
104
+ sourceMapPath,
105
+ }: Awaited<ReturnType<typeof bundleWorker>> = noBundle
106
+ ? {
107
+ modules: [],
108
+ resolvedEntryPointPath: entry.file,
109
+ bundleType: entry.format === "modules" ? "esm" : "commonjs",
110
+ stop: undefined,
111
+ sourceMapPath: undefined,
112
+ }
113
+ : await bundleWorker(entry, destination, {
114
+ serveAssetsFromWorker,
115
+ jsxFactory,
116
+ jsxFragment,
117
+ rules,
118
+ watch: watchMode,
119
+ tsconfig,
120
+ minify,
121
+ nodeCompat,
122
+ betaD1Shims,
123
+ define,
124
+ checkFetch: true,
125
+ assets: assets && {
126
+ ...assets,
127
+ // disable the cache in dev
128
+ bypassCache: true,
129
+ },
130
+ workerDefinitions,
131
+ services,
132
+ firstPartyWorkerDevFacade,
133
+ local,
134
+ targetConsumer,
135
+ testScheduled,
136
+ experimentalLocalStubCache,
137
+ });
138
+
139
+ // Capture the `stop()` method to use as the `useEffect()` destructor.
140
+ stopWatching = stop;
141
+
142
+ // if "noBundle" is true, then we need to manually watch the entry point and
143
+ // trigger "builds" when it changes
144
+ if (noBundle) {
145
+ const watcher = watch(entry.file, {
146
+ persistent: true,
147
+ }).on("change", async (_event) => {
148
+ updateBundle();
149
+ });
150
+
151
+ stopWatching = () => {
152
+ watcher.close();
153
+ };
154
+ }
155
+ setBundle({
156
+ id: 0,
157
+ entry,
158
+ path: resolvedEntryPointPath,
159
+ type: bundleType,
160
+ modules,
161
+ sourceMapPath,
162
+ });
163
+ }
164
+
165
+ build().catch((err) => {
166
+ // If esbuild fails on first run, we want to quit the process
167
+ // since we can't recover from here
168
+ // related: https://github.com/evanw/esbuild/issues/1037
169
+ exit(err);
170
+ });
171
+
172
+ return () => {
173
+ stopWatching?.();
174
+ };
175
+ }, [
176
+ entry,
177
+ destination,
178
+ jsxFactory,
179
+ jsxFragment,
180
+ serveAssetsFromWorker,
181
+ rules,
182
+ tsconfig,
183
+ exit,
184
+ noBundle,
185
+ minify,
186
+ nodeCompat,
187
+ define,
188
+ assets,
189
+ services,
190
+ durableObjects,
191
+ workerDefinitions,
192
+ firstPartyWorkerDevFacade,
193
+ betaD1Shims,
194
+ local,
195
+ targetConsumer,
196
+ testScheduled,
197
+ experimentalLocalStubCache,
198
+ ]);
199
+ return bundle;
200
+ }