wrangler 0.0.0-fb43821 → 0.0.0-fbfc24d7

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 (221) hide show
  1. package/Cloudflare_CA.pem +18 -0
  2. package/README.md +51 -14
  3. package/bin/wrangler.js +160 -28
  4. package/kv-asset-handler.js +1 -0
  5. package/miniflare-dist/index.mjs +5542 -0
  6. package/package.json +172 -113
  7. package/src/__tests__/config-cache-without-cache-dir.test.ts +38 -0
  8. package/src/__tests__/config-cache.test.ts +42 -0
  9. package/src/__tests__/configuration.test.ts +4026 -0
  10. package/src/__tests__/dev.test.tsx +1316 -0
  11. package/src/__tests__/generate.test.ts +91 -0
  12. package/src/__tests__/guess-worker-format.test.ts +85 -0
  13. package/src/__tests__/{clipboardy-mock.js → helpers/clipboardy-mock.js} +0 -0
  14. package/src/__tests__/helpers/cmd-shim.d.ts +11 -0
  15. package/src/__tests__/helpers/mock-account-id.ts +48 -0
  16. package/src/__tests__/helpers/mock-bin.ts +36 -0
  17. package/src/__tests__/helpers/mock-cfetch.ts +296 -0
  18. package/src/__tests__/helpers/mock-console.ts +97 -0
  19. package/src/__tests__/helpers/mock-dialogs.ts +153 -0
  20. package/src/__tests__/helpers/mock-get-zone-from-host.ts +8 -0
  21. package/src/__tests__/helpers/mock-http-server.ts +46 -0
  22. package/src/__tests__/helpers/mock-istty.ts +74 -0
  23. package/src/__tests__/helpers/mock-known-routes.ts +7 -0
  24. package/src/__tests__/helpers/mock-kv.ts +33 -0
  25. package/src/__tests__/helpers/mock-oauth-flow.ts +250 -0
  26. package/src/__tests__/helpers/mock-process.ts +39 -0
  27. package/src/__tests__/helpers/mock-stdin.ts +108 -0
  28. package/src/__tests__/helpers/mock-web-socket.ts +29 -0
  29. package/src/__tests__/helpers/run-in-tmp.ts +38 -0
  30. package/src/__tests__/helpers/run-wrangler.ts +16 -0
  31. package/src/__tests__/helpers/write-worker-source.ts +31 -0
  32. package/src/__tests__/helpers/write-wrangler-toml.ts +17 -0
  33. package/src/__tests__/https-options.test.ts +163 -0
  34. package/src/__tests__/index.test.ts +242 -419
  35. package/src/__tests__/init.test.ts +2170 -0
  36. package/src/__tests__/jest.setup.ts +157 -0
  37. package/src/__tests__/kv.test.ts +1671 -0
  38. package/src/__tests__/logger.test.ts +141 -0
  39. package/src/__tests__/metrics.test.ts +450 -0
  40. package/src/__tests__/package-manager.test.ts +353 -0
  41. package/src/__tests__/pages.test.ts +1275 -0
  42. package/src/__tests__/parse.test.ts +330 -0
  43. package/src/__tests__/publish.test.ts +6903 -0
  44. package/src/__tests__/pubsub.test.ts +367 -0
  45. package/src/__tests__/r2.test.ts +336 -0
  46. package/src/__tests__/route.test.ts +45 -0
  47. package/src/__tests__/secret.test.ts +492 -0
  48. package/src/__tests__/tail.test.ts +802 -0
  49. package/src/__tests__/test-old-node-version.js +31 -0
  50. package/src/__tests__/user.test.ts +155 -0
  51. package/src/__tests__/validate-dev-props.test.ts +56 -0
  52. package/src/__tests__/version.test.ts +35 -0
  53. package/src/__tests__/whoami.test.tsx +289 -0
  54. package/src/__tests__/worker-namespace.test.ts +329 -0
  55. package/src/abort.d.ts +3 -0
  56. package/src/api/dev.ts +93 -0
  57. package/src/api/index.ts +1 -0
  58. package/src/bundle-reporter.tsx +29 -0
  59. package/src/bundle.ts +473 -0
  60. package/src/cfetch/index.ts +121 -0
  61. package/src/cfetch/internal.ts +237 -0
  62. package/src/cli.ts +25 -8
  63. package/src/config/README.md +107 -0
  64. package/src/config/config.ts +263 -0
  65. package/src/config/diagnostics.ts +80 -0
  66. package/src/config/environment.ts +485 -0
  67. package/src/config/index.ts +251 -0
  68. package/src/config/validation-helpers.ts +597 -0
  69. package/src/config/validation.ts +1862 -0
  70. package/src/config-cache.ts +85 -0
  71. package/src/create-worker-preview.ts +257 -0
  72. package/src/create-worker-upload-form.ts +288 -0
  73. package/src/dev/dev-vars.ts +36 -0
  74. package/src/dev/dev.tsx +545 -0
  75. package/src/dev/local.tsx +449 -0
  76. package/src/dev/remote.tsx +421 -0
  77. package/src/dev/use-esbuild.ts +178 -0
  78. package/src/dev/validate-dev-props.ts +31 -0
  79. package/src/dev-registry.tsx +160 -0
  80. package/src/dev.tsx +612 -764
  81. package/src/dialogs.tsx +117 -59
  82. package/src/dispatch-namespace.ts +206 -0
  83. package/src/durable.ts +102 -0
  84. package/src/entry.ts +328 -0
  85. package/src/environment-variables.ts +35 -0
  86. package/src/errors.ts +11 -0
  87. package/src/faye-websocket.d.ts +6 -0
  88. package/src/generate.ts +131 -0
  89. package/src/git-client.ts +42 -0
  90. package/src/global-wrangler-config-path.ts +26 -0
  91. package/src/https-options.ts +127 -0
  92. package/src/index.tsx +2213 -1857
  93. package/src/init.ts +622 -0
  94. package/src/inspect.ts +747 -0
  95. package/src/intl-polyfill.d.ts +139 -0
  96. package/src/is-ci.ts +14 -0
  97. package/src/is-interactive.ts +12 -0
  98. package/src/kv.ts +430 -0
  99. package/src/logger.ts +73 -0
  100. package/src/metrics/index.ts +5 -0
  101. package/src/metrics/metrics-config.ts +239 -0
  102. package/src/metrics/metrics-dispatcher.ts +96 -0
  103. package/src/metrics/metrics-usage-headers.ts +24 -0
  104. package/src/metrics/send-event.ts +92 -0
  105. package/src/miniflare-cli/README.md +30 -0
  106. package/src/miniflare-cli/assets.ts +554 -0
  107. package/src/miniflare-cli/enum-keys.ts +17 -0
  108. package/src/miniflare-cli/index.ts +207 -0
  109. package/src/miniflare-cli/request-context.ts +40 -0
  110. package/src/module-collection.ts +247 -53
  111. package/src/open-in-browser.ts +17 -0
  112. package/src/package-manager.ts +219 -0
  113. package/src/pages/build.tsx +238 -0
  114. package/src/pages/constants.ts +12 -0
  115. package/src/pages/deployments.tsx +106 -0
  116. package/src/pages/dev.tsx +528 -0
  117. package/src/pages/errors.ts +22 -0
  118. package/src/pages/functions/buildPlugin.ts +109 -0
  119. package/src/pages/functions/buildWorker.ts +155 -0
  120. package/src/pages/functions/filepath-routing.test.ts +234 -0
  121. package/src/pages/functions/filepath-routing.ts +189 -0
  122. package/src/pages/functions/identifiers.ts +78 -0
  123. package/src/pages/functions/routes-consolidation.test.ts +250 -0
  124. package/src/pages/functions/routes-consolidation.ts +73 -0
  125. package/src/pages/functions/routes-transformation.test.ts +271 -0
  126. package/src/pages/functions/routes-transformation.ts +122 -0
  127. package/src/pages/functions/routes.ts +151 -0
  128. package/src/pages/functions.tsx +96 -0
  129. package/src/pages/index.tsx +94 -0
  130. package/src/pages/projects.tsx +169 -0
  131. package/src/pages/publish.tsx +391 -0
  132. package/src/pages/types.ts +49 -0
  133. package/src/pages/upload.tsx +413 -0
  134. package/src/pages/utils.ts +12 -0
  135. package/src/parse.ts +286 -0
  136. package/src/paths.ts +26 -0
  137. package/src/preview.ts +31 -0
  138. package/src/proxy.ts +486 -0
  139. package/src/publish.ts +796 -335
  140. package/src/pubsub/index.ts +286 -0
  141. package/src/pubsub/pubsub-commands.tsx +623 -0
  142. package/src/r2.ts +131 -0
  143. package/src/selfsigned.d.ts +29 -0
  144. package/src/sites.tsx +357 -100
  145. package/src/tail/filters.ts +281 -0
  146. package/src/tail/index.ts +312 -0
  147. package/src/tail/printing.ts +107 -0
  148. package/src/update-check.ts +19 -0
  149. package/src/user/choose-account.tsx +69 -0
  150. package/src/user/env-vars.ts +46 -0
  151. package/src/user/generate-auth-url.ts +33 -0
  152. package/src/user/generate-random-state.ts +16 -0
  153. package/src/user/index.ts +3 -0
  154. package/src/user/user.tsx +1191 -0
  155. package/src/whoami.tsx +169 -0
  156. package/src/worker.ts +203 -0
  157. package/src/zones.ts +167 -0
  158. package/templates/checked-fetch.js +17 -0
  159. package/templates/first-party-worker-module-facade.ts +18 -0
  160. package/templates/format-dev-errors.ts +32 -0
  161. package/templates/gitignore +171 -0
  162. package/templates/new-worker-scheduled.js +17 -0
  163. package/templates/new-worker-scheduled.ts +32 -0
  164. package/templates/new-worker.js +15 -0
  165. package/templates/new-worker.ts +30 -0
  166. package/templates/no-op-worker.js +10 -0
  167. package/templates/pages-shim.ts +9 -0
  168. package/templates/pages-template-plugin.ts +167 -0
  169. package/templates/pages-template-worker.ts +172 -0
  170. package/templates/serve-static-assets.ts +63 -0
  171. package/templates/service-bindings-module-facade.js +54 -0
  172. package/templates/service-bindings-sw-facade.js +42 -0
  173. package/templates/tsconfig.json +105 -0
  174. package/wrangler-dist/cli.d.ts +338 -0
  175. package/wrangler-dist/cli.js +127880 -101761
  176. package/src/__tests__/mock-cfetch.js +0 -42
  177. package/src/api/form_data.ts +0 -141
  178. package/src/api/inspect.ts +0 -430
  179. package/src/api/preview.ts +0 -128
  180. package/src/api/worker.ts +0 -161
  181. package/src/cfetch.ts +0 -72
  182. package/src/config.ts +0 -122
  183. package/src/kv.tsx +0 -211
  184. package/src/pages.tsx +0 -818
  185. package/src/tail.tsx +0 -71
  186. package/src/user.tsx +0 -1029
  187. package/static-asset-facade.js +0 -47
  188. package/vendor/@cloudflare/kv-asset-handler/CHANGELOG.md +0 -332
  189. package/vendor/@cloudflare/kv-asset-handler/LICENSE_APACHE +0 -176
  190. package/vendor/@cloudflare/kv-asset-handler/LICENSE_MIT +0 -25
  191. package/vendor/@cloudflare/kv-asset-handler/README.md +0 -245
  192. package/vendor/@cloudflare/kv-asset-handler/dist/index.d.ts +0 -32
  193. package/vendor/@cloudflare/kv-asset-handler/dist/index.js +0 -354
  194. package/vendor/@cloudflare/kv-asset-handler/dist/mocks.d.ts +0 -13
  195. package/vendor/@cloudflare/kv-asset-handler/dist/mocks.js +0 -148
  196. package/vendor/@cloudflare/kv-asset-handler/dist/test/getAssetFromKV.d.ts +0 -1
  197. package/vendor/@cloudflare/kv-asset-handler/dist/test/getAssetFromKV.js +0 -436
  198. package/vendor/@cloudflare/kv-asset-handler/dist/test/mapRequestToAsset.d.ts +0 -1
  199. package/vendor/@cloudflare/kv-asset-handler/dist/test/mapRequestToAsset.js +0 -40
  200. package/vendor/@cloudflare/kv-asset-handler/dist/test/serveSinglePageApp.d.ts +0 -1
  201. package/vendor/@cloudflare/kv-asset-handler/dist/test/serveSinglePageApp.js +0 -42
  202. package/vendor/@cloudflare/kv-asset-handler/dist/types.d.ts +0 -26
  203. package/vendor/@cloudflare/kv-asset-handler/dist/types.js +0 -31
  204. package/vendor/@cloudflare/kv-asset-handler/package.json +0 -52
  205. package/vendor/@cloudflare/kv-asset-handler/src/index.ts +0 -296
  206. package/vendor/@cloudflare/kv-asset-handler/src/mocks.ts +0 -136
  207. package/vendor/@cloudflare/kv-asset-handler/src/test/getAssetFromKV.ts +0 -464
  208. package/vendor/@cloudflare/kv-asset-handler/src/test/mapRequestToAsset.ts +0 -33
  209. package/vendor/@cloudflare/kv-asset-handler/src/test/serveSinglePageApp.ts +0 -42
  210. package/vendor/@cloudflare/kv-asset-handler/src/types.ts +0 -39
  211. package/vendor/wrangler-mime/CHANGELOG.md +0 -289
  212. package/vendor/wrangler-mime/LICENSE +0 -21
  213. package/vendor/wrangler-mime/Mime.js +0 -97
  214. package/vendor/wrangler-mime/README.md +0 -187
  215. package/vendor/wrangler-mime/cli.js +0 -46
  216. package/vendor/wrangler-mime/index.js +0 -4
  217. package/vendor/wrangler-mime/lite.js +0 -4
  218. package/vendor/wrangler-mime/package.json +0 -52
  219. package/vendor/wrangler-mime/types/other.js +0 -1
  220. package/vendor/wrangler-mime/types/standard.js +0 -1
  221. package/wrangler-dist/cli.js.map +0 -7
package/src/bundle.ts ADDED
@@ -0,0 +1,473 @@
1
+ import assert from "node:assert";
2
+ import * as fs from "node:fs";
3
+ import { builtinModules } from "node:module";
4
+ import * as path from "node:path";
5
+ import NodeGlobalsPolyfills from "@esbuild-plugins/node-globals-polyfill";
6
+ import NodeModulesPolyfills from "@esbuild-plugins/node-modules-polyfill";
7
+ import * as esbuild from "esbuild";
8
+ import tmp from "tmp-promise";
9
+ import createModuleCollector from "./module-collection";
10
+ import type { Config } from "./config";
11
+ import type { WorkerRegistry } from "./dev-registry";
12
+ import type { Entry } from "./entry";
13
+ import type { CfModule } from "./worker";
14
+
15
+ type BundleResult = {
16
+ modules: CfModule[];
17
+ resolvedEntryPointPath: string;
18
+ bundleType: "esm" | "commonjs";
19
+ stop: (() => void) | undefined;
20
+ sourceMapPath?: string | undefined;
21
+ };
22
+
23
+ type StaticAssetsConfig =
24
+ | (Config["assets"] & {
25
+ bypassCache: boolean | undefined;
26
+ })
27
+ | undefined;
28
+
29
+ /**
30
+ * Searches for any uses of node's builtin modules, and throws an error if it
31
+ * finds anything. This plugin is only used when nodeCompat is not enabled.
32
+ * Supports both regular node builtins, and the new "node:<MODULE>" format.
33
+ */
34
+ const checkForNodeBuiltinsPlugin = {
35
+ name: "checkForNodeBuiltins",
36
+ setup(build: esbuild.PluginBuild) {
37
+ build.onResolve(
38
+ {
39
+ filter: new RegExp(
40
+ "^(" +
41
+ builtinModules.join("|") +
42
+ "|" +
43
+ builtinModules.map((module) => "node:" + module).join("|") +
44
+ ")$"
45
+ ),
46
+ },
47
+ () => {
48
+ throw new Error(
49
+ `Detected a Node builtin module import while Node compatibility is disabled.\nAdd node_compat = true to your wrangler.toml file to enable Node compatibility.`
50
+ );
51
+ }
52
+ );
53
+ },
54
+ };
55
+
56
+ /**
57
+ * Generate a bundle for the worker identified by the arguments passed in.
58
+ */
59
+ export async function bundleWorker(
60
+ entry: Entry,
61
+ destination: string,
62
+ options: {
63
+ serveAssetsFromWorker: boolean;
64
+ assets: StaticAssetsConfig;
65
+ jsxFactory: string | undefined;
66
+ jsxFragment: string | undefined;
67
+ rules: Config["rules"];
68
+ watch?: esbuild.WatchMode;
69
+ tsconfig: string | undefined;
70
+ minify: boolean | undefined;
71
+ nodeCompat: boolean | undefined;
72
+ define: Config["define"];
73
+ checkFetch: boolean;
74
+ services: Config["services"];
75
+ workerDefinitions: WorkerRegistry | undefined;
76
+ firstPartyWorkerDevFacade: boolean | undefined;
77
+ }
78
+ ): Promise<BundleResult> {
79
+ const {
80
+ serveAssetsFromWorker,
81
+ jsxFactory,
82
+ jsxFragment,
83
+ rules,
84
+ watch,
85
+ tsconfig,
86
+ minify,
87
+ nodeCompat,
88
+ checkFetch,
89
+ assets,
90
+ workerDefinitions,
91
+ services,
92
+ firstPartyWorkerDevFacade,
93
+ } = options;
94
+
95
+ // We create a temporary directory for any oneoff files we
96
+ // need to create. This is separate from the main build
97
+ // directory (`destination`).
98
+ const tmpDir = await tmp.dir({ unsafeCleanup: true });
99
+
100
+ const entryDirectory = path.dirname(entry.file);
101
+ const moduleCollector = createModuleCollector({
102
+ wrangler1xlegacyModuleReferences: {
103
+ rootDirectory: entryDirectory,
104
+ fileNames: new Set(
105
+ fs
106
+ .readdirSync(entryDirectory, { withFileTypes: true })
107
+ .filter(
108
+ (dirEntry) =>
109
+ dirEntry.isFile() && dirEntry.name !== path.basename(entry.file)
110
+ )
111
+ .map((dirEnt) => dirEnt.name)
112
+ ),
113
+ },
114
+ format: entry.format,
115
+ rules,
116
+ });
117
+
118
+ // In dev, we want to patch `fetch()` with a special version that looks
119
+ // for bad usages and can warn the user about them; so we inject
120
+ // `checked-fetch.js` to do so. However, with yarn 3 style pnp,
121
+ // we need to extract that file to an accessible place before injecting
122
+ // it in, hence this code here.
123
+
124
+ const checkedFetchFileToInject = path.join(tmpDir.path, "checked-fetch.js");
125
+
126
+ if (checkFetch && !fs.existsSync(checkedFetchFileToInject)) {
127
+ fs.mkdirSync(tmpDir.path, {
128
+ recursive: true,
129
+ });
130
+ fs.writeFileSync(
131
+ checkedFetchFileToInject,
132
+ fs.readFileSync(path.resolve(__dirname, "../templates/checked-fetch.js"))
133
+ );
134
+ }
135
+
136
+ // At this point, we take the opportunity to "wrap" any input workers
137
+ // with any extra functionality we may want to add. This is done by
138
+ // passing the entry point through a pipeline of functions that return
139
+ // a new entry point, that we call "middleware" or "facades".
140
+ // Look at implementations of these functions to learn more.
141
+
142
+ type MiddlewareFn = (arg0: Entry) => Promise<Entry>;
143
+ const middleware: (false | undefined | MiddlewareFn)[] = [
144
+ // serve static assets
145
+ serveAssetsFromWorker &&
146
+ ((currentEntry: Entry) => {
147
+ return applyStaticAssetFacade(currentEntry, tmpDir.path, assets);
148
+ }),
149
+ // format errors nicely
150
+ // We use an env var here because we don't actually
151
+ // want to expose this to the user. It's only used internally to
152
+ // experiment with middleware as a teaching exercise.
153
+ process.env.FORMAT_WRANGLER_ERRORS === "true" &&
154
+ ((currentEntry: Entry) => {
155
+ return applyFormatDevErrorsFacade(currentEntry, tmpDir.path);
156
+ }),
157
+ // bind to other dev instances/service bindings
158
+ workerDefinitions &&
159
+ Object.keys(workerDefinitions).length > 0 &&
160
+ services &&
161
+ services.length > 0 &&
162
+ ((currentEntry: Entry) => {
163
+ return applyMultiWorkerDevFacade(
164
+ currentEntry,
165
+ tmpDir.path,
166
+ services,
167
+ workerDefinitions
168
+ );
169
+ }),
170
+ // Simulate internal environment when using first party workers in dev
171
+ firstPartyWorkerDevFacade === true &&
172
+ ((currentEntry: Entry) => {
173
+ return applyFirstPartyWorkerDevFacade(currentEntry, tmpDir.path);
174
+ }),
175
+ ].filter(Boolean);
176
+
177
+ let inputEntry = entry;
178
+
179
+ for (const middlewareFn of middleware as MiddlewareFn[]) {
180
+ inputEntry = await middlewareFn(inputEntry);
181
+ }
182
+
183
+ // At this point, inputEntry points to the entry point we want to build.
184
+
185
+ const result = await esbuild.build({
186
+ entryPoints: [inputEntry.file],
187
+ bundle: true,
188
+ absWorkingDir: entry.directory,
189
+ outdir: destination,
190
+ inject: checkFetch ? [checkedFetchFileToInject] : [],
191
+ external: ["__STATIC_CONTENT_MANIFEST"],
192
+ format: entry.format === "modules" ? "esm" : "iife",
193
+ target: "es2020",
194
+ sourcemap: true,
195
+ // Include a reference to the output folder in the sourcemap.
196
+ // This is omitted by default, but we need it to properly resolve source paths in error output.
197
+ sourceRoot: destination,
198
+ minify,
199
+ metafile: true,
200
+ conditions: ["worker", "browser"],
201
+ ...(process.env.NODE_ENV && {
202
+ define: {
203
+ // use process.env["NODE_ENV" + ""] so that esbuild doesn't replace it
204
+ // when we do a build of wrangler. (re: https://github.com/cloudflare/wrangler2/issues/1477)
205
+ "process.env.NODE_ENV": `"${process.env["NODE_ENV" + ""]}"`,
206
+ ...(nodeCompat ? { global: "globalThis" } : {}),
207
+ ...(checkFetch ? { fetch: "checkedFetch" } : {}),
208
+ ...options.define,
209
+ },
210
+ }),
211
+ loader: {
212
+ ".js": "jsx",
213
+ ".mjs": "jsx",
214
+ ".cjs": "jsx",
215
+ },
216
+ plugins: [
217
+ moduleCollector.plugin,
218
+ ...(nodeCompat
219
+ ? [NodeGlobalsPolyfills({ buffer: true }), NodeModulesPolyfills()]
220
+ : // we use checkForNodeBuiltinsPlugin to throw a nicer error
221
+ // if we find node builtins when nodeCompat isn't turned on
222
+ [checkForNodeBuiltinsPlugin]),
223
+ ],
224
+ ...(jsxFactory && { jsxFactory }),
225
+ ...(jsxFragment && { jsxFragment }),
226
+ ...(tsconfig && { tsconfig }),
227
+ watch,
228
+ });
229
+
230
+ const entryPointOutputs = Object.entries(result.metafile.outputs).filter(
231
+ ([_path, output]) => output.entryPoint !== undefined
232
+ );
233
+ assert(
234
+ entryPointOutputs.length > 0,
235
+ `Cannot find entry-point "${entry.file}" in generated bundle.` +
236
+ listEntryPoints(entryPointOutputs)
237
+ );
238
+ assert(
239
+ entryPointOutputs.length < 2,
240
+ "More than one entry-point found for generated bundle." +
241
+ listEntryPoints(entryPointOutputs)
242
+ );
243
+
244
+ const entryPointExports = entryPointOutputs[0][1].exports;
245
+ const bundleType = entryPointExports.length > 0 ? "esm" : "commonjs";
246
+
247
+ const sourceMapPath = Object.keys(result.metafile.outputs).filter((_path) =>
248
+ _path.includes(".map")
249
+ )[0];
250
+
251
+ return {
252
+ modules: moduleCollector.modules,
253
+ resolvedEntryPointPath: path.resolve(
254
+ entry.directory,
255
+ entryPointOutputs[0][0]
256
+ ),
257
+ bundleType,
258
+ stop: result.stop,
259
+ sourceMapPath,
260
+ };
261
+ }
262
+
263
+ /**
264
+ * A simple plugin to alias modules and mark them as external
265
+ */
266
+ function esbuildAliasExternalPlugin(
267
+ aliases: Record<string, string>
268
+ ): esbuild.Plugin {
269
+ return {
270
+ name: "alias",
271
+ setup(build) {
272
+ build.onResolve({ filter: /.*/g }, (args) => {
273
+ // If it's the entrypoint, let it be as is
274
+ if (args.kind === "entry-point") {
275
+ return {
276
+ path: args.path,
277
+ };
278
+ }
279
+ // If it's not a recognised alias, then throw an error
280
+ if (!Object.keys(aliases).includes(args.path)) {
281
+ throw new Error("unrecognized module: " + args.path);
282
+ }
283
+
284
+ // Otherwise, return the alias
285
+ return {
286
+ path: aliases[args.path as keyof typeof aliases],
287
+ external: true,
288
+ };
289
+ });
290
+ },
291
+ };
292
+ }
293
+
294
+ /**
295
+ * A middleware that catches any thrown errors, and instead formats
296
+ * them to be rendered in a browser. This middleware is for demonstration
297
+ * purposes only, and is not intended to be used in production (or even dev!)
298
+ */
299
+ async function applyFormatDevErrorsFacade(
300
+ entry: Entry,
301
+ tmpDirPath: string
302
+ ): Promise<Entry> {
303
+ const targetPath = path.join(tmpDirPath, "format-dev-errors.entry.js");
304
+ await esbuild.build({
305
+ entryPoints: [path.resolve(__dirname, "../templates/format-dev-errors.ts")],
306
+ bundle: true,
307
+ sourcemap: true,
308
+ format: "esm",
309
+ plugins: [
310
+ esbuildAliasExternalPlugin({
311
+ __ENTRY_POINT__: entry.file,
312
+ }),
313
+ ],
314
+ outfile: targetPath,
315
+ });
316
+
317
+ return {
318
+ ...entry,
319
+ file: targetPath,
320
+ };
321
+ }
322
+
323
+ /**
324
+ * A middleware that serves static assets from a worker.
325
+ * This powers --assets / config.assets
326
+ */
327
+
328
+ async function applyStaticAssetFacade(
329
+ entry: Entry,
330
+ tmpDirPath: string,
331
+ assets: StaticAssetsConfig
332
+ ): Promise<Entry> {
333
+ const targetPath = path.join(tmpDirPath, "serve-static-assets.entry.js");
334
+
335
+ await esbuild.build({
336
+ entryPoints: [
337
+ path.resolve(__dirname, "../templates/serve-static-assets.ts"),
338
+ ],
339
+ bundle: true,
340
+ format: "esm",
341
+ sourcemap: true,
342
+ plugins: [
343
+ esbuildAliasExternalPlugin({
344
+ __ENTRY_POINT__: entry.file,
345
+ __KV_ASSET_HANDLER__: path.join(__dirname, "../kv-asset-handler.js"),
346
+ __STATIC_CONTENT_MANIFEST: "__STATIC_CONTENT_MANIFEST",
347
+ }),
348
+ ],
349
+ define: {
350
+ __CACHE_CONTROL_OPTIONS__: JSON.stringify(
351
+ typeof assets === "object"
352
+ ? {
353
+ browserTTL:
354
+ assets.browser_TTL || 172800 /* 2 days: 2* 60 * 60 * 24 */,
355
+ bypassCache: assets.bypassCache,
356
+ }
357
+ : {}
358
+ ),
359
+ __SERVE_SINGLE_PAGE_APP__: JSON.stringify(
360
+ typeof assets === "object" ? assets.serve_single_page_app : false
361
+ ),
362
+ },
363
+ outfile: targetPath,
364
+ });
365
+
366
+ return {
367
+ ...entry,
368
+ file: targetPath,
369
+ };
370
+ }
371
+
372
+ /**
373
+ * A middleware that enables service bindings to be used in dev,
374
+ * binding to other love wrangler dev instances
375
+ */
376
+
377
+ async function applyMultiWorkerDevFacade(
378
+ entry: Entry,
379
+ tmpDirPath: string,
380
+ services: Config["services"],
381
+ workerDefinitions: WorkerRegistry
382
+ ) {
383
+ const targetPath = path.join(tmpDirPath, "multiworker-dev-facade.entry.js");
384
+ const serviceMap = Object.fromEntries(
385
+ (services || []).map((serviceBinding) => [
386
+ serviceBinding.binding,
387
+ workerDefinitions[serviceBinding.service] || null,
388
+ ])
389
+ );
390
+
391
+ await esbuild.build({
392
+ entryPoints: [
393
+ path.join(
394
+ __dirname,
395
+ entry.format === "modules"
396
+ ? "../templates/service-bindings-module-facade.js"
397
+ : "../templates/service-bindings-sw-facade.js"
398
+ ),
399
+ ],
400
+ bundle: true,
401
+ sourcemap: true,
402
+ format: "esm",
403
+ plugins: [
404
+ esbuildAliasExternalPlugin({
405
+ __ENTRY_POINT__: entry.file,
406
+ }),
407
+ ],
408
+ define: {
409
+ __WORKERS__: JSON.stringify(serviceMap),
410
+ },
411
+ outfile: targetPath,
412
+ });
413
+
414
+ return {
415
+ ...entry,
416
+ file: targetPath,
417
+ };
418
+ }
419
+
420
+ /**
421
+ * A middleware that makes first party workers "work" in
422
+ * our dev environments. Is applied during wrangler dev
423
+ * when config.first_party_worker is true
424
+ */
425
+ async function applyFirstPartyWorkerDevFacade(
426
+ entry: Entry,
427
+ tmpDirPath: string
428
+ ) {
429
+ if (entry.format !== "modules") {
430
+ throw new Error(
431
+ "First party workers must be in the modules format. See https://developers.cloudflare.com/workers/learning/migrating-to-module-workers/"
432
+ );
433
+ }
434
+
435
+ const targetPath = path.join(
436
+ tmpDirPath,
437
+ "first-party-worker-module-facade.entry.js"
438
+ );
439
+
440
+ await esbuild.build({
441
+ entryPoints: [
442
+ path.resolve(
443
+ __dirname,
444
+ "../templates/first-party-worker-module-facade.ts"
445
+ ),
446
+ ],
447
+ bundle: true,
448
+ format: "esm",
449
+ sourcemap: true,
450
+ plugins: [
451
+ esbuildAliasExternalPlugin({
452
+ __ENTRY_POINT__: entry.file,
453
+ }),
454
+ ],
455
+ outfile: targetPath,
456
+ });
457
+
458
+ return {
459
+ ...entry,
460
+ file: targetPath,
461
+ };
462
+ }
463
+
464
+ /**
465
+ * Generate a string that describes the entry-points that were identified by esbuild.
466
+ */
467
+ function listEntryPoints(
468
+ outputs: [string, ValueOf<esbuild.Metafile["outputs"]>][]
469
+ ): string {
470
+ return outputs.map(([_input, output]) => output.entryPoint).join("\n");
471
+ }
472
+
473
+ type ValueOf<T> = T[keyof T];
@@ -0,0 +1,121 @@
1
+ import { URLSearchParams } from "node:url";
2
+ import { ParseError } from "../parse";
3
+ import { fetchInternal } from "./internal";
4
+ import type { RequestInit } from "undici";
5
+
6
+ // Check out https://api.cloudflare.com/ for API docs.
7
+
8
+ export { getCloudflareAPIBaseURL as getCloudflareApiBaseUrl } from "./internal";
9
+
10
+ export interface FetchError {
11
+ code: number;
12
+ message: string;
13
+ error_chain?: FetchError[];
14
+ }
15
+ export interface FetchResult<ResponseType = unknown> {
16
+ success: boolean;
17
+ result: ResponseType;
18
+ errors: FetchError[];
19
+ messages: string[];
20
+ result_info?: unknown;
21
+ }
22
+
23
+ export { fetchKVGetValue } from "./internal";
24
+
25
+ /**
26
+ * Make a fetch request, and extract the `result` from the JSON response.
27
+ */
28
+ export async function fetchResult<ResponseType>(
29
+ resource: string,
30
+ init: RequestInit = {},
31
+ queryParams?: URLSearchParams,
32
+ abortSignal?: AbortSignal
33
+ ): Promise<ResponseType> {
34
+ const json = await fetchInternal<FetchResult<ResponseType>>(
35
+ resource,
36
+ init,
37
+ queryParams,
38
+ abortSignal
39
+ );
40
+ if (json.success) {
41
+ return json.result;
42
+ } else {
43
+ throwFetchError(resource, json);
44
+ }
45
+ }
46
+
47
+ /**
48
+ * Make a fetch request for a list of values,
49
+ * extracting the `result` from the JSON response,
50
+ * and repeating the request if the results are paginated.
51
+ */
52
+ export async function fetchListResult<ResponseType>(
53
+ resource: string,
54
+ init: RequestInit = {},
55
+ queryParams?: URLSearchParams
56
+ ): Promise<ResponseType[]> {
57
+ const results: ResponseType[] = [];
58
+ let getMoreResults = true;
59
+ let cursor: string | undefined;
60
+ while (getMoreResults) {
61
+ if (cursor) {
62
+ queryParams = new URLSearchParams(queryParams);
63
+ queryParams.set("cursor", cursor);
64
+ }
65
+ const json = await fetchInternal<FetchResult<ResponseType[]>>(
66
+ resource,
67
+ init,
68
+ queryParams
69
+ );
70
+ if (json.success) {
71
+ results.push(...json.result);
72
+ if (hasCursor(json.result_info)) {
73
+ cursor = json.result_info?.cursor;
74
+ } else {
75
+ getMoreResults = false;
76
+ }
77
+ } else {
78
+ throwFetchError(resource, json);
79
+ }
80
+ }
81
+ return results;
82
+ }
83
+
84
+ function throwFetchError(
85
+ resource: string,
86
+ response: FetchResult<unknown>
87
+ ): never {
88
+ const error = new ParseError({
89
+ text: `A request to the Cloudflare API (${resource}) failed.`,
90
+ notes: response.errors.map((err) => ({
91
+ text: renderError(err),
92
+ })),
93
+ });
94
+ // add the first error code directly to this error
95
+ // so consumers can use it for specific behaviour
96
+ const code = response.errors[0]?.code;
97
+ if (code) {
98
+ //@ts-expect-error non-standard property on Error
99
+ error.code = code;
100
+ }
101
+ throw error;
102
+ }
103
+
104
+ function hasCursor(result_info: unknown): result_info is { cursor: string } {
105
+ const cursor = (result_info as { cursor: string } | undefined)?.cursor;
106
+ return cursor !== undefined && cursor !== null && cursor !== "";
107
+ }
108
+
109
+ function renderError(err: FetchError, level = 0): string {
110
+ const chainedMessages =
111
+ err.error_chain
112
+ ?.map(
113
+ (chainedError) =>
114
+ `\n${" ".repeat(level)}- ${renderError(chainedError, level + 1)}`
115
+ )
116
+ .join("\n") ?? "";
117
+ return (
118
+ (err.code ? `${err.message} [code: ${err.code}]` : err.message) +
119
+ chainedMessages
120
+ );
121
+ }