wrangler 0.0.0-d86200d2 → 0.0.0-d86a157ee

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 (44) hide show
  1. package/README.md +29 -43
  2. package/bin/wrangler.js +5 -28
  3. package/config-schema.json +3161 -0
  4. package/package.json +184 -191
  5. package/templates/__tests__/tsconfig.json +1 -1
  6. package/templates/checked-fetch.js +10 -3
  7. package/templates/facade.d.ts +7 -2
  8. package/templates/gitignore +2 -4
  9. package/templates/init-tests/test-vitest-new-worker.js +1 -1
  10. package/templates/init-tests/test-vitest-new-worker.ts +1 -1
  11. package/templates/middleware/loader-modules.ts +94 -44
  12. package/templates/middleware/loader-sw.ts +4 -3
  13. package/templates/middleware/middleware-ensure-req-body-drained.ts +18 -0
  14. package/templates/middleware/middleware-mock-analytics-engine.d.ts +3 -0
  15. package/templates/middleware/middleware-mock-analytics-engine.ts +30 -0
  16. package/templates/middleware/middleware-patch-console-prefix.d.ts +3 -0
  17. package/templates/middleware/middleware-patch-console-prefix.ts +21 -0
  18. package/templates/middleware/middleware-scheduled.ts +15 -1
  19. package/templates/middleware/middleware-serve-static-assets.d.ts +6 -0
  20. package/templates/middleware/middleware-serve-static-assets.ts +56 -0
  21. package/templates/modules-watch-stub.js +4 -0
  22. package/templates/pages-dev-pipeline.ts +2 -1
  23. package/templates/pages-template-plugin.ts +14 -4
  24. package/templates/pages-template-worker.ts +12 -3
  25. package/templates/startDevWorker/InspectorProxyWorker.ts +664 -0
  26. package/templates/startDevWorker/ProxyWorker.ts +336 -0
  27. package/templates/tsconfig.init.json +4 -87
  28. package/templates/tsconfig.json +1 -1
  29. package/wrangler-dist/InspectorProxyWorker.js +464 -0
  30. package/wrangler-dist/InspectorProxyWorker.js.map +6 -0
  31. package/wrangler-dist/ProxyWorker.js +241 -0
  32. package/wrangler-dist/ProxyWorker.js.map +6 -0
  33. package/wrangler-dist/cli.d.ts +25057 -255
  34. package/wrangler-dist/cli.js +140615 -111733
  35. package/Cloudflare_CA.pem +0 -18
  36. package/templates/__tests__/tsconfig.tsbuildinfo +0 -1
  37. package/templates/d1-beta-facade.js +0 -244
  38. package/templates/first-party-worker-module-facade.ts +0 -19
  39. package/templates/format-dev-errors.ts +0 -34
  40. package/templates/serve-static-assets.ts +0 -66
  41. package/templates/service-bindings-module-facade.js +0 -55
  42. package/templates/service-bindings-sw-facade.js +0 -42
  43. package/templates/tsconfig.tsbuildinfo +0 -1
  44. package/wrangler-dist/wasm-sync.wasm +0 -0
package/README.md CHANGED
@@ -3,82 +3,68 @@
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
- > This package is for wrangler v2.x, released first in May 2022. If you're looking for v1.x of the `@cloudflare/wrangler` package, visit https://www.npmjs.com/package/@cloudflare/wrangler / https://github.com/cloudflare/wrangler-legacy.
10
-
11
9
  `wrangler` is a command line tool for building [Cloudflare Workers](https://workers.cloudflare.com/).
12
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
+
13
15
  ## Quick Start
14
16
 
17
+ To get started quickly with a Hello World worker, run the command below:
18
+
15
19
  ```bash
16
- # Make a javascript file
17
- echo "export default { fetch() { return new Response('hello world') } }" > index.js
18
- # try it out
19
- npx wrangler dev index.js
20
- # and then deploy it
21
- npx wrangler deploy index.js --name my-worker
22
- # visit https://my-worker.<your workers subdomain>.workers.dev
20
+ npx wrangler init my-worker -y
23
21
  ```
24
22
 
25
- ## Create a Project
23
+ For more info, visit our [Getting Started](https://developers.cloudflare.com/workers/get-started/guide/) guide.
26
24
 
27
- ```bash
28
- # Generate a new project
29
- npx wrangler init my-worker
30
- # try it out
31
- cd my-worker && npm run start
32
- # and then deploy it
33
- npm run deploy
34
- ```
25
+ ## Documentation
35
26
 
36
- ## Installation:
27
+ For the latest Wrangler documentation, [click here](https://developers.cloudflare.com/workers/wrangler/).
37
28
 
38
- ```bash
39
- $ npm install wrangler --save-dev
40
- ```
29
+ To read more about Workers in general:
41
30
 
42
- ## 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/)
43
35
 
44
- 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
45
37
 
46
- 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:
47
39
 
48
40
  ```toml
49
- main = "./src/index.ts" # init w/ TypeScript
50
41
  name = "my-worker"
51
- compatibility_date = "YYY-MM-DD"
42
+ main = "./src/index.ts"
43
+ compatibility_date = "YYYY-MM-DD"
52
44
  ```
53
45
 
54
- for more detailed information about configuration, see the [documentation](https://developers.cloudflare.com/workers/cli-wrangler/configuration)
46
+ For more detailed information about configuration, refer to the [documentation](https://developers.cloudflare.com/workers/wrangler/configuration/).
55
47
 
56
48
  ## Commands
57
49
 
58
- ### `wrangler init [name]`
50
+ ### Workers
59
51
 
60
- Creates a Worker project. For details on configuration keys and values, refer to the [documentation](https://developers.cloudflare.com/workers/wrangler/commands/#init).
61
-
62
- ### `wrangler dev`
52
+ #### `wrangler dev`
63
53
 
64
54
  Start a local development server, with live reloading and devtools.
65
55
 
66
- ### `wrangler deploy`
56
+ #### `wrangler deploy`
67
57
 
68
- Publish the given script to the worldwide Cloudflare network.
58
+ Publish the given script to Cloudflare's global network.
69
59
 
70
- For more commands and options, refer to the [documentation](https://developers.cloudflare.com/workers/cli-wrangler/commands).
60
+ For more commands and options, refer to the [documentation](https://developers.cloudflare.com/workers/wrangler/commands/).
71
61
 
72
- ## Pages
62
+ ### Pages
73
63
 
74
- ### `wrangler pages dev [directory] [-- command]`
64
+ #### `wrangler pages dev [directory]`
75
65
 
76
- Either serves a static build asset directory, or proxies itself in front of a command.
66
+ Serves a static build asset directory.
77
67
 
78
68
  Builds and runs functions from a `./functions` directory or uses a `_worker.js` file inside the static build asset directory.
79
69
 
80
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`.
81
-
82
- ## Documentation
83
-
84
- 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) =>
@@ -76,6 +48,11 @@ Consider using a Node.js version manager such as https://volta.sh/ or https://gi
76
48
  if (process.send) {
77
49
  process.send(message);
78
50
  }
51
+ })
52
+ .on("disconnect", () => {
53
+ if (process.disconnect) {
54
+ process.disconnect();
55
+ }
79
56
  });
80
57
  }
81
58