wrangler 0.0.0-fa42550d → 0.0.0-fa5a8fc30

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 (32) hide show
  1. package/README.md +26 -38
  2. package/bin/wrangler.js +0 -28
  3. package/config-schema.json +3300 -0
  4. package/package.json +49 -92
  5. package/templates/checked-fetch.js +1 -1
  6. package/templates/facade.d.ts +7 -5
  7. package/templates/gitignore +3 -0
  8. package/templates/init-tests/test-vitest-new-worker.ts +2 -2
  9. package/templates/middleware/loader-modules.ts +92 -94
  10. package/templates/middleware/middleware-ensure-req-body-drained.ts +0 -1
  11. package/templates/middleware/middleware-miniflare3-json-error.ts +0 -1
  12. package/templates/middleware/middleware-mock-analytics-engine.d.ts +3 -0
  13. package/templates/middleware/middleware-mock-analytics-engine.ts +30 -0
  14. package/templates/middleware/middleware-patch-console-prefix.d.ts +3 -0
  15. package/templates/middleware/middleware-patch-console-prefix.ts +21 -0
  16. package/templates/middleware/middleware-scheduled.ts +15 -1
  17. package/templates/middleware/middleware-serve-static-assets.ts +2 -2
  18. package/templates/pages-template-plugin.ts +2 -2
  19. package/templates/pages-template-worker.ts +1 -1
  20. package/templates/startDevWorker/InspectorProxyWorker.ts +4 -1
  21. package/templates/startDevWorker/ProxyWorker.ts +35 -25
  22. package/templates/tsconfig.init.json +4 -87
  23. package/wrangler-dist/InspectorProxyWorker.js.map +1 -1
  24. package/wrangler-dist/ProxyWorker.js +28 -24
  25. package/wrangler-dist/ProxyWorker.js.map +1 -1
  26. package/wrangler-dist/cli.d.ts +3497 -701
  27. package/wrangler-dist/cli.js +113377 -103416
  28. package/Cloudflare_CA.pem +0 -18
  29. package/templates/middleware/middleware-d1-beta.d.ts +0 -3
  30. package/templates/middleware/middleware-multiworker-dev.d.ts +0 -4
  31. package/templates/middleware/middleware-multiworker-dev.ts +0 -68
  32. package/wrangler-dist/wasm-sync.wasm +0 -0
package/README.md CHANGED
@@ -3,49 +3,43 @@
3
3
  <a href="https://www.npmjs.com/package/wrangler"><img alt="npm" src="https://img.shields.io/npm/dw/wrangler?style=flat-square"></a>
4
4
  <img alt="GitHub contributors" src="https://img.shields.io/github/contributors/cloudflare/workers-sdk?style=flat-square">
5
5
  <img alt="GitHub commit activity (branch)" src="https://img.shields.io/github/commit-activity/w/cloudflare/workers-sdk/main?style=flat-square">
6
- <a href="https://discord.gg/CloudflareDev"><img alt="Discord" src="https://img.shields.io/discord/595317990191398933?color=%23F48120&style=flat-square"></a>
6
+ <a href="https://discord.cloudflare.com"><img alt="Discord" src="https://img.shields.io/discord/595317990191398933?color=%23F48120&style=flat-square"></a>
7
7
  </section>
8
8
 
9
9
  `wrangler` is a command line tool for building [Cloudflare Workers](https://workers.cloudflare.com/).
10
10
 
11
+ > [!WARNING]
12
+ >
13
+ > Wrangler v2 is **only receiving critical security updates.** We recommend you [migrate to Wrangler v3](https://developers.cloudflare.com/workers/wrangler/migration/update-v2-to-v3/) if you can.
14
+
11
15
  ## Quick Start
12
16
 
17
+ To get started quickly with a Hello World worker, run the command below:
18
+
13
19
  ```bash
14
- # Make a javascript file
15
- echo "export default { fetch() { return new Response('hello world') } }" > index.js
16
- # try it out
17
- npx wrangler dev index.js
18
- # and then deploy it
19
- npx wrangler deploy index.js --name my-worker
20
- # visit https://my-worker.<your workers subdomain>.workers.dev
20
+ npx wrangler init my-worker -y
21
21
  ```
22
22
 
23
- ## Create a Project
23
+ For more info, visit our [Getting Started](https://developers.cloudflare.com/workers/get-started/guide/) guide.
24
24
 
25
- ```bash
26
- # Generate a new project
27
- npx wrangler init my-worker --no-delegate-c3
28
- # try it out
29
- cd my-worker && npm run start
30
- # and then deploy it
31
- npm run deploy
32
- ```
25
+ ## Documentation
33
26
 
34
- ## Installation:
27
+ For the latest Wrangler documentation, [click here](https://developers.cloudflare.com/workers/wrangler/).
35
28
 
36
- ```bash
37
- $ npm install wrangler --save-dev
38
- ```
29
+ To read more about Workers in general:
39
30
 
40
- ## Configuration:
31
+ - [Getting Started](https://developers.cloudflare.com/workers/get-started/guide/)
32
+ - [How Workers works](https://developers.cloudflare.com/workers/reference/how-workers-works/)
33
+ - [Observability](https://developers.cloudflare.com/workers/observability/)
34
+ - [Platform](https://developers.cloudflare.com/workers/platform/)
41
35
 
42
- Wrangler is configured via a `wrangler.toml` file in the project root. When utilizing the `wrangler init` command, a `wrangler.toml` file will be created for you.
36
+ ## Configuration
43
37
 
44
- Example:
38
+ Wrangler is configured via a `wrangler.toml` or `wrangler.json` file in the project root. An example configuration generated by `npx wrangler init` or `npx create cloudflare` is as follows:
45
39
 
46
40
  ```toml
47
41
  name = "my-worker"
48
- main = "./src/index.ts" # init w/ TypeScript
42
+ main = "./src/index.ts"
49
43
  compatibility_date = "YYYY-MM-DD"
50
44
  ```
51
45
 
@@ -53,30 +47,24 @@ For more detailed information about configuration, refer to the [documentation](
53
47
 
54
48
  ## Commands
55
49
 
56
- ### `wrangler init [name]`
57
-
58
- Creates a Worker project. For details on configuration keys and values, refer to the [documentation](https://developers.cloudflare.com/workers/wrangler/commands/#init).
50
+ ### Workers
59
51
 
60
- ### `wrangler dev`
52
+ #### `wrangler dev`
61
53
 
62
54
  Start a local development server, with live reloading and devtools.
63
55
 
64
- ### `wrangler deploy`
56
+ #### `wrangler deploy`
65
57
 
66
- Publish the given script to the worldwide Cloudflare network.
58
+ Publish the given script to Cloudflare's global network.
67
59
 
68
60
  For more commands and options, refer to the [documentation](https://developers.cloudflare.com/workers/wrangler/commands/).
69
61
 
70
- ## Pages
62
+ ### Pages
71
63
 
72
- ### `wrangler pages dev [directory] [-- command]`
64
+ #### `wrangler pages dev [directory]`
73
65
 
74
- Either serves a static build asset directory, or proxies itself in front of a command.
66
+ Serves a static build asset directory.
75
67
 
76
68
  Builds and runs functions from a `./functions` directory or uses a `_worker.js` file inside the static build asset directory.
77
69
 
78
70
  For more commands and options, refer to the [documentation](https://developers.cloudflare.com/pages/platform/functions#develop-and-preview-locally) or run `wrangler pages dev --help`.
79
-
80
- ## Documentation
81
-
82
- For the latest Wrangler documentation, [click here](https://developers.cloudflare.com/workers/wrangler/).
package/bin/wrangler.js CHANGED
@@ -28,30 +28,6 @@ Consider using a Node.js version manager such as https://volta.sh/ or https://gi
28
28
  return;
29
29
  }
30
30
 
31
- let pathToCACerts = process.env.NODE_EXTRA_CA_CERTS;
32
- if (pathToCACerts) {
33
- // TODO:
34
- // - should we log a warning here?
35
- // - maybe we can generate a certificate that concatenates with ours?
36
- //
37
- // I do think it'll be rare that someone wants to add a cert AND
38
- // use Cloudflare WARP, but let's wait till the situation actually
39
- // arises before we do anything about it
40
- } else {
41
- const osTempDir = os.tmpdir();
42
- const certDir = path.join(osTempDir, "wrangler-cert");
43
- const certPath = path.join(certDir, "Cloudflare_CA.pem");
44
- // copy cert to the system temp dir if needed
45
- if (!fs.existsSync(certPath)) {
46
- fs.mkdirSync(certDir, { recursive: true });
47
- fs.writeFileSync(
48
- certPath,
49
- fs.readFileSync(path.join(__dirname, "../Cloudflare_CA.pem"), "utf-8")
50
- );
51
- }
52
- pathToCACerts = certPath;
53
- }
54
-
55
31
  return spawn(
56
32
  process.execPath,
57
33
  [
@@ -63,10 +39,6 @@ Consider using a Node.js version manager such as https://volta.sh/ or https://gi
63
39
  ],
64
40
  {
65
41
  stdio: ["inherit", "inherit", "inherit", "ipc"],
66
- env: {
67
- ...process.env,
68
- NODE_EXTRA_CA_CERTS: pathToCACerts,
69
- },
70
42
  }
71
43
  )
72
44
  .on("exit", (code) =>