create-cloudflare 0.0.0-fb819f997 → 0.0.0-fbba583df

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 (167) hide show
  1. package/dist/cli.js +11811 -11392
  2. package/dist/tsconfig.tsbuildinfo +1 -1
  3. package/package.json +12 -7
  4. package/templates/analog/templates/worker-configuration.d.ts +1 -1
  5. package/templates/analog/templates/wrangler.jsonc +5 -0
  6. package/templates/angular/c3.ts +24 -5
  7. package/templates/astro/templates/js/wrangler.jsonc +8 -0
  8. package/templates/astro/templates/ts/worker-configuration.d.ts +1 -1
  9. package/templates/astro/templates/ts/wrangler.jsonc +8 -0
  10. package/templates/common/js/package.json +1 -1
  11. package/templates/common/js/wrangler.jsonc +8 -0
  12. package/templates/common/ts/package.json +1 -1
  13. package/templates/common/ts/src/index.ts +1 -1
  14. package/templates/common/ts/worker-configuration.d.ts +1 -1
  15. package/templates/common/ts/wrangler.jsonc +8 -0
  16. package/templates/docusaurus/c3.ts +1 -0
  17. package/templates/hello-world/c3.ts +17 -1
  18. package/templates/hello-world/js/package.json +3 -3
  19. package/templates/hello-world/js/test/index.spec.js +1 -1
  20. package/templates/hello-world/js/vitest.config.js +1 -1
  21. package/templates/hello-world/js/wrangler.jsonc +8 -0
  22. package/templates/hello-world/py/.python-version +1 -0
  23. package/templates/hello-world/py/README.md +23 -0
  24. package/templates/hello-world/py/package.json +1 -1
  25. package/templates/hello-world/py/pyproject.toml +9 -0
  26. package/templates/hello-world/py/uv.lock +22 -0
  27. package/templates/hello-world/py/wrangler.jsonc +9 -0
  28. package/templates/hello-world/ts/package.json +3 -3
  29. package/templates/hello-world/ts/src/index.ts +1 -1
  30. package/templates/hello-world/ts/vitest.config.mts +1 -1
  31. package/templates/hello-world/ts/worker-configuration.d.ts +1 -1
  32. package/templates/hello-world/ts/wrangler.jsonc +8 -0
  33. package/templates/hello-world-durable-object/js/package.json +1 -1
  34. package/templates/hello-world-durable-object/js/src/index.js +3 -3
  35. package/templates/hello-world-durable-object/js/wrangler.jsonc +24 -0
  36. package/templates/hello-world-durable-object/ts/package.json +1 -1
  37. package/templates/hello-world-durable-object/ts/src/index.ts +4 -4
  38. package/templates/hello-world-durable-object/ts/wrangler.jsonc +24 -0
  39. package/templates/hono/c3.ts +1 -0
  40. package/templates/hono/templates/worker-configuration.d.ts +1 -1
  41. package/templates/hono/templates/wrangler.jsonc +8 -0
  42. package/templates/next/README.md +2 -3
  43. package/templates/next/c3.ts +13 -28
  44. package/templates/next/wrangler.jsonc +8 -0
  45. package/templates/nuxt/templates/worker-configuration.d.ts +1 -1
  46. package/templates/nuxt/templates/wrangler.jsonc +8 -0
  47. package/templates/openapi/ts/package.json +1 -1
  48. package/templates/openapi/ts/worker-configuration.d.ts +1 -1
  49. package/templates/openapi/ts/wrangler.jsonc +8 -0
  50. package/templates/pre-existing/c3.ts +3 -3
  51. package/templates/pre-existing/js/package.json +1 -1
  52. package/templates/queues/js/package.json +1 -1
  53. package/templates/queues/js/wrangler.jsonc +21 -0
  54. package/templates/queues/ts/package.json +1 -1
  55. package/templates/queues/ts/src/index.ts +1 -1
  56. package/templates/queues/ts/worker-configuration.d.ts +1 -1
  57. package/templates/queues/ts/wrangler.jsonc +21 -0
  58. package/templates/qwik/c3.ts +3 -2
  59. package/templates/qwik/templates/worker-configuration.d.ts +1 -1
  60. package/templates/qwik/templates/wrangler.jsonc +8 -0
  61. package/templates/remix/templates/worker-configuration.d.ts +1 -1
  62. package/templates/remix/templates/wrangler.jsonc +5 -0
  63. package/templates/scheduled/js/package.json +1 -1
  64. package/templates/scheduled/js/src/index.js +1 -1
  65. package/templates/scheduled/js/wrangler.jsonc +13 -0
  66. package/templates/scheduled/ts/package.json +1 -1
  67. package/templates/scheduled/ts/src/index.ts +4 -4
  68. package/templates/scheduled/ts/worker-configuration.d.ts +1 -1
  69. package/templates/scheduled/ts/wrangler.jsonc +13 -0
  70. package/templates/solid/c3.ts +1 -1
  71. package/templates/solid/templates/wrangler.jsonc +8 -0
  72. package/templates/svelte/templates/wrangler.jsonc +5 -0
  73. package/templates-experimental/angular/c3.ts +23 -5
  74. package/templates-experimental/angular/templates/wrangler.jsonc +12 -0
  75. package/templates-experimental/astro/templates/js/wrangler.jsonc +15 -0
  76. package/templates-experimental/astro/templates/ts/worker-configuration.d.ts +1 -1
  77. package/templates-experimental/astro/templates/ts/wrangler.jsonc +15 -0
  78. package/templates-experimental/docusaurus/c3.ts +1 -0
  79. package/templates-experimental/docusaurus/templates/wrangler.jsonc +10 -0
  80. package/templates-experimental/gatsby/templates/wrangler.jsonc +10 -0
  81. package/templates-experimental/hello-world-assets-only/templates/wrangler.jsonc +10 -0
  82. package/templates-experimental/hello-world-durable-object-with-assets/js/package.json +1 -1
  83. package/templates-experimental/hello-world-durable-object-with-assets/js/src/index.js +3 -3
  84. package/templates-experimental/hello-world-durable-object-with-assets/js/wrangler.jsonc +28 -0
  85. package/templates-experimental/hello-world-durable-object-with-assets/ts/package.json +1 -1
  86. package/templates-experimental/hello-world-durable-object-with-assets/ts/src/index.ts +3 -3
  87. package/templates-experimental/hello-world-durable-object-with-assets/ts/wrangler.jsonc +28 -0
  88. package/templates-experimental/hello-world-with-assets/js/package.json +3 -3
  89. package/templates-experimental/hello-world-with-assets/js/vitest.config.js +1 -1
  90. package/templates-experimental/hello-world-with-assets/js/wrangler.jsonc +15 -0
  91. package/templates-experimental/hello-world-with-assets/py/package.json +1 -1
  92. package/templates-experimental/hello-world-with-assets/py/wrangler.jsonc +15 -0
  93. package/templates-experimental/hello-world-with-assets/ts/package.json +3 -3
  94. package/templates-experimental/hello-world-with-assets/ts/src/index.ts +1 -1
  95. package/templates-experimental/hello-world-with-assets/ts/vitest.config.mts +1 -1
  96. package/templates-experimental/hello-world-with-assets/ts/worker-configuration.d.ts +1 -1
  97. package/templates-experimental/hello-world-with-assets/ts/wrangler.jsonc +15 -0
  98. package/templates-experimental/hono/c3.ts +1 -0
  99. package/templates-experimental/hono/templates/worker-configuration.d.ts +1 -1
  100. package/templates-experimental/hono/templates/wrangler.jsonc +9 -0
  101. package/templates-experimental/next/c3.ts +35 -16
  102. package/templates-experimental/next/templates/.dev.vars +2 -0
  103. package/templates-experimental/next/templates/__dot__gitignore +2 -5
  104. package/templates-experimental/next/templates/cloudflare-env.d.ts +5 -0
  105. package/templates-experimental/next/templates/open-next.config.ts +28 -0
  106. package/templates-experimental/next/templates/wrangler.jsonc +13 -0
  107. package/templates-experimental/nuxt/templates/worker-configuration.d.ts +1 -1
  108. package/templates-experimental/nuxt/templates/wrangler.jsonc +12 -0
  109. package/templates-experimental/qwik/c3.ts +3 -2
  110. package/templates-experimental/qwik/templates/worker-configuration.d.ts +1 -1
  111. package/templates-experimental/qwik/templates/wrangler.jsonc +15 -0
  112. package/templates-experimental/react/c3.ts +182 -0
  113. package/templates-experimental/react/js/api/index.js +13 -0
  114. package/templates-experimental/react/js/src/App.jsx +58 -0
  115. package/templates-experimental/react/js/src/assets/Cloudflare_Logo.svg +26 -0
  116. package/templates-experimental/react/js/wrangler.json +9 -0
  117. package/templates-experimental/react/ts/api/index.ts +17 -0
  118. package/templates-experimental/react/ts/src/App.tsx +58 -0
  119. package/templates-experimental/react/ts/src/assets/Cloudflare_Logo.svg +26 -0
  120. package/templates-experimental/react/ts/tsconfig.worker.json +8 -0
  121. package/templates-experimental/react/ts/wrangler.json +9 -0
  122. package/templates-experimental/solid/c3.ts +1 -1
  123. package/templates-experimental/solid/templates/wrangler.jsonc +15 -0
  124. package/templates-experimental/svelte/templates/wrangler.jsonc +12 -0
  125. package/templates-experimental/vue/templates/wrangler.jsonc +10 -0
  126. package/templates/analog/templates/wrangler.toml +0 -85
  127. package/templates/astro/templates/js/wrangler.toml +0 -86
  128. package/templates/astro/templates/ts/wrangler.toml +0 -86
  129. package/templates/common/js/wrangler.toml +0 -113
  130. package/templates/common/ts/wrangler.toml +0 -113
  131. package/templates/hello-world/js/wrangler.toml +0 -114
  132. package/templates/hello-world/py/wrangler.toml +0 -114
  133. package/templates/hello-world/ts/wrangler.toml +0 -114
  134. package/templates/hello-world-durable-object/js/wrangler.toml +0 -113
  135. package/templates/hello-world-durable-object/ts/wrangler.toml +0 -113
  136. package/templates/hono/templates/wrangler.toml +0 -113
  137. package/templates/next/wrangler.toml +0 -86
  138. package/templates/nuxt/templates/wrangler.toml +0 -86
  139. package/templates/openapi/ts/wrangler.toml +0 -113
  140. package/templates/pre-existing/js/wrangler.toml +0 -4
  141. package/templates/queues/js/wrangler.toml +0 -118
  142. package/templates/queues/ts/wrangler.toml +0 -118
  143. package/templates/qwik/templates/wrangler.toml +0 -86
  144. package/templates/remix/templates/wrangler.toml +0 -85
  145. package/templates/scheduled/js/wrangler.toml +0 -119
  146. package/templates/scheduled/ts/wrangler.toml +0 -119
  147. package/templates/solid/templates/wrangler.toml +0 -84
  148. package/templates/svelte/templates/wrangler.toml +0 -85
  149. package/templates-experimental/angular/templates/wrangler.toml +0 -11
  150. package/templates-experimental/astro/templates/js/wrangler.toml +0 -12
  151. package/templates-experimental/astro/templates/ts/wrangler.toml +0 -12
  152. package/templates-experimental/docusaurus/templates/wrangler.toml +0 -10
  153. package/templates-experimental/gatsby/templates/wrangler.toml +0 -10
  154. package/templates-experimental/hello-world-assets-only/templates/wrangler.toml +0 -10
  155. package/templates-experimental/hello-world-durable-object-with-assets/js/wrangler.toml +0 -24
  156. package/templates-experimental/hello-world-durable-object-with-assets/ts/wrangler.toml +0 -24
  157. package/templates-experimental/hello-world-with-assets/js/wrangler.toml +0 -12
  158. package/templates-experimental/hello-world-with-assets/py/wrangler.toml +0 -12
  159. package/templates-experimental/hello-world-with-assets/ts/wrangler.toml +0 -12
  160. package/templates-experimental/hono/templates/wrangler.toml +0 -5
  161. package/templates-experimental/next/templates/env.d.ts +0 -5
  162. package/templates-experimental/next/templates/wrangler.toml +0 -12
  163. package/templates-experimental/nuxt/templates/wrangler.toml +0 -11
  164. package/templates-experimental/qwik/templates/wrangler.toml +0 -12
  165. package/templates-experimental/solid/templates/wrangler.toml +0 -12
  166. package/templates-experimental/svelte/templates/wrangler.toml +0 -11
  167. package/templates-experimental/vue/templates/wrangler.toml +0 -10
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-cloudflare",
3
- "version": "0.0.0-fb819f997",
3
+ "version": "0.0.0-fbba583df",
4
4
  "description": "A CLI for creating and deploying new applications to Cloudflare.",
5
5
  "keywords": [
6
6
  "cloudflare",
@@ -30,7 +30,7 @@
30
30
  "@babel/parser": "^7.21.3",
31
31
  "@babel/types": "^7.21.4",
32
32
  "@clack/prompts": "^0.6.3",
33
- "@cloudflare/workers-types": "^4.20241205.0",
33
+ "@cloudflare/workers-types": "^4.20250224.0",
34
34
  "@iarna/toml": "^3.0.0",
35
35
  "@types/command-exists": "^1.2.0",
36
36
  "@types/cross-spawn": "^6.0.2",
@@ -38,7 +38,7 @@
38
38
  "@types/degit": "^2.8.6",
39
39
  "@types/dns2": "^2.0.3",
40
40
  "@types/esprima": "^4.0.3",
41
- "@types/node": "^18.19.59",
41
+ "@types/node": "^18.19.75",
42
42
  "@types/semver": "^7.5.1",
43
43
  "@types/which-pm-runs": "^1.0.0",
44
44
  "@types/yargs": "^17.0.22",
@@ -46,6 +46,7 @@
46
46
  "@typescript-eslint/parser": "^6.9.0",
47
47
  "chalk": "^5.2.0",
48
48
  "command-exists": "^1.2.9",
49
+ "comment-json": "^4.2.5",
49
50
  "cross-spawn": "^7.0.3",
50
51
  "deepmerge": "^4.3.1",
51
52
  "degit": "^2.8.4",
@@ -59,9 +60,12 @@
59
60
  "magic-string": "^0.30.5",
60
61
  "open": "^8.4.0",
61
62
  "recast": "^0.22.0",
62
- "semver": "^7.5.1",
63
- "undici": "^5.28.4",
63
+ "semver": "^7.7.1",
64
+ "typescript": "^5.7.2",
65
+ "undici": "^5.28.5",
66
+ "vite": "^5.4.14",
64
67
  "vite-tsconfig-paths": "^4.0.8",
68
+ "vitest": "~3.0.5",
65
69
  "which-pm-runs": "^1.1.0",
66
70
  "wrap-ansi": "^9.0.0",
67
71
  "xdg-app-paths": "^8.3.0",
@@ -69,7 +73,8 @@
69
73
  "@cloudflare/cli": "1.1.1",
70
74
  "@cloudflare/eslint-config-worker": "1.1.0",
71
75
  "@cloudflare/workers-tsconfig": "0.0.0",
72
- "wrangler": "0.0.0-fb819f997"
76
+ "wrangler": "0.0.0-fbba583df",
77
+ "@cloudflare/mock-npm-registry": "0.0.0"
73
78
  },
74
79
  "engines": {
75
80
  "node": ">=18.14.1"
@@ -93,7 +98,7 @@
93
98
  "test:e2e:yarn": "pnpm run build && cross-env TEST_PM=yarn vitest run --config ./vitest-e2e.config.mts",
94
99
  "test:unit": "vitest run --config ./vitest.config.mts",
95
100
  "test:unit:watch": "vitest --config ./vitest.config.mts",
96
- "watch": "node -r esbuild-register scripts/build.ts --watch",
101
+ "dev": "node -r esbuild-register scripts/build.ts --watch",
97
102
  "test:ci": "vitest run --config ./vitest.config.mts"
98
103
  }
99
104
  }
@@ -1,4 +1,4 @@
1
1
  // Generated by Wrangler
2
- // After adding bindings to `wrangler.toml`, regenerate this interface via `npm run cf-typegen`
2
+ // After adding bindings to `wrangler.jsonc`, regenerate this interface via `npm run cf-typegen`
3
3
  interface Env {
4
4
  }
@@ -0,0 +1,5 @@
1
+ {
2
+ "name": "<TBD>",
3
+ "compatibility_date": "<TBD>",
4
+ "pages_build_output_dir": "./dist/analog/public"
5
+ }
@@ -8,7 +8,7 @@ import { readFile, readJSON, writeFile } from "helpers/files";
8
8
  import { detectPackageManager } from "helpers/packageManagers";
9
9
  import { installPackages } from "helpers/packages";
10
10
  import type { TemplateConfig } from "../../src/templates";
11
- import type { C3Context } from "types";
11
+ import type { C3Context, PackageJson } from "types";
12
12
 
13
13
  const { npm } = detectPackageManager();
14
14
 
@@ -64,10 +64,10 @@ async function updateAppCode() {
64
64
  // Remove unwanted dependencies
65
65
  s.start(`Updating package.json`);
66
66
  const packageJsonPath = resolve("package.json");
67
- const packageManifest = readJSON(packageJsonPath);
67
+ const packageManifest = readJSON(packageJsonPath) as PackageJson;
68
68
 
69
- delete packageManifest["dependencies"]["express"];
70
- delete packageManifest["devDependencies"]["@types/express"];
69
+ delete packageManifest["dependencies"]?.["express"];
70
+ delete packageManifest["devDependencies"]?.["@types/express"];
71
71
 
72
72
  writeFile(packageJsonPath, JSON.stringify(packageManifest, null, 2));
73
73
  s.stop(`${brandColor(`updated`)} ${dim(`\`package.json\``)}`);
@@ -76,7 +76,8 @@ async function updateAppCode() {
76
76
  function updateAngularJson(ctx: C3Context) {
77
77
  const s = spinner();
78
78
  s.start(`Updating angular.json config`);
79
- const angularJson = readJSON(resolve("angular.json"));
79
+ const angularJson = readJSON("angular.json") as AngularJson;
80
+
80
81
  // Update builder
81
82
  const architectSection = angularJson.projects[ctx.project.name].architect;
82
83
  architectSection.build.options.outputPath = "dist";
@@ -112,3 +113,21 @@ const config: TemplateConfig = {
112
113
  }),
113
114
  };
114
115
  export default config;
116
+
117
+ type AngularJson = {
118
+ projects: Record<
119
+ string,
120
+ {
121
+ architect: {
122
+ build: {
123
+ options: {
124
+ outputPath: string;
125
+ outputMode: string;
126
+ ssr: Record<string, unknown>;
127
+ assets: string[];
128
+ };
129
+ };
130
+ };
131
+ }
132
+ >;
133
+ };
@@ -0,0 +1,8 @@
1
+ {
2
+ "name": "<TBD>",
3
+ "compatibility_date": "<TBD>",
4
+ "compatibility_flags": [
5
+ "nodejs_compat"
6
+ ],
7
+ "pages_build_output_dir": "./dist"
8
+ }
@@ -1,4 +1,4 @@
1
1
  // Generated by Wrangler
2
- // After adding bindings to `wrangler.toml`, regenerate this interface via `npm run cf-typegen`
2
+ // After adding bindings to `wrangler.jsonc`, regenerate this interface via `npm run cf-typegen`
3
3
  interface Env {
4
4
  }
@@ -0,0 +1,8 @@
1
+ {
2
+ "name": "<TBD>",
3
+ "compatibility_date": "<TBD>",
4
+ "compatibility_flags": [
5
+ "nodejs_compat"
6
+ ],
7
+ "pages_build_output_dir": "./dist"
8
+ }
@@ -9,6 +9,6 @@
9
9
  },
10
10
  "devDependencies": {
11
11
  "itty-router": "^3.0.12",
12
- "wrangler": "^3.60.3"
12
+ "wrangler": "^3.101.0"
13
13
  }
14
14
  }
@@ -0,0 +1,8 @@
1
+ {
2
+ "name": "<TBD>",
3
+ "main": "src/index.js",
4
+ "compatibility_date": "<TBD>",
5
+ "observability": {
6
+ "enabled": true
7
+ }
8
+ }
@@ -11,6 +11,6 @@
11
11
  "devDependencies": {
12
12
  "itty-router": "^3.0.12",
13
13
  "typescript": "^5.5.2",
14
- "wrangler": "^3.60.3"
14
+ "wrangler": "^3.101.0"
15
15
  }
16
16
  }
@@ -5,7 +5,7 @@
5
5
  * - Open a browser tab at http://localhost:8787/ to see your worker in action
6
6
  * - Run `npm run deploy` to publish your worker
7
7
  *
8
- * Bind resources to your worker in `wrangler.toml`. After adding bindings, a type definition for the
8
+ * Bind resources to your Worker in `wrangler.jsonc`. After adding bindings, a type definition for the
9
9
  * `Env` object can be regenerated with `npm run cf-typegen`.
10
10
  *
11
11
  * Learn more at https://developers.cloudflare.com/workers/
@@ -1,4 +1,4 @@
1
1
  // Generated by Wrangler
2
- // After adding bindings to `wrangler.toml`, regenerate this interface via `npm run cf-typegen`
2
+ // After adding bindings to `wrangler.jsonc`, regenerate this interface via `npm run cf-typegen`
3
3
  interface Env {
4
4
  }
@@ -0,0 +1,8 @@
1
+ {
2
+ "name": "<TBD>",
3
+ "main": "src/index.ts",
4
+ "compatibility_date": "<TBD>",
5
+ "observability": {
6
+ "enabled": true
7
+ }
8
+ }
@@ -24,5 +24,6 @@ const config: TemplateConfig = {
24
24
  }),
25
25
  devScript: "preview",
26
26
  deployScript: "deploy",
27
+ previewScript: "preview",
27
28
  };
28
29
  export default config;
@@ -1,9 +1,25 @@
1
+ import { readFile, writeFile } from "node:fs/promises";
2
+ import { resolve } from "node:path";
3
+ import type { TemplateConfig } from "../../src/templates";
4
+
1
5
  export default {
2
6
  configVersion: 1,
3
7
  id: "hello-world",
4
8
  displayName: "Hello World Worker",
5
9
  description: "Get started with a basic Worker in the language of your choice",
6
10
  platform: "workers",
11
+ async configure(ctx) {
12
+ if (ctx.args.lang === "python") {
13
+ for (const file of ["pyproject.toml", "uv.lock"]) {
14
+ const contents = await readFile(
15
+ resolve(ctx.project.path, file),
16
+ "utf8",
17
+ );
18
+ const updated = contents.replaceAll(/<TBD>/g, ctx.project.name);
19
+ await writeFile(resolve(ctx.project.path, file), updated);
20
+ }
21
+ }
22
+ },
7
23
  copyFiles: {
8
24
  variants: {
9
25
  js: {
@@ -17,4 +33,4 @@ export default {
17
33
  },
18
34
  },
19
35
  },
20
- };
36
+ } satisfies TemplateConfig;
@@ -9,8 +9,8 @@
9
9
  "test": "vitest"
10
10
  },
11
11
  "devDependencies": {
12
- "@cloudflare/vitest-pool-workers": "^0.5.2",
13
- "wrangler": "^3.60.3",
14
- "vitest": "2.1.8"
12
+ "@cloudflare/vitest-pool-workers": "^0.6.4",
13
+ "wrangler": "^3.101.0",
14
+ "vitest": "~2.1.9"
15
15
  }
16
16
  }
@@ -14,7 +14,7 @@ describe('Hello World worker', () => {
14
14
  });
15
15
 
16
16
  it('responds with Hello World! (integration style)', async () => {
17
- const response = await SELF.fetch(request, env, ctx);
17
+ const response = await SELF.fetch('http://example.com');
18
18
  expect(await response.text()).toMatchInlineSnapshot(`"Hello World!"`);
19
19
  });
20
20
  });
@@ -4,7 +4,7 @@ export default defineWorkersConfig({
4
4
  test: {
5
5
  poolOptions: {
6
6
  workers: {
7
- wrangler: { configPath: './wrangler.toml' },
7
+ wrangler: { configPath: './wrangler.jsonc' },
8
8
  },
9
9
  },
10
10
  },
@@ -0,0 +1,8 @@
1
+ {
2
+ "name": "<TBD>",
3
+ "main": "src/index.js",
4
+ "compatibility_date": "<TBD>",
5
+ "observability": {
6
+ "enabled": true,
7
+ },
8
+ }
@@ -0,0 +1 @@
1
+ 3.12
@@ -0,0 +1,23 @@
1
+ ## Usage
2
+
3
+ You can run the worker defined by your new project by executing `wrangler dev` in this
4
+ directory. This will start up an HTTP server and will allow you to iterate on your
5
+ worker without having to restart `wrangler`.
6
+
7
+ ### Types and autocomplete
8
+
9
+ This project also includes a pyproject.toml and uv.lock file with some requirements which
10
+ set up autocomplete and type hints for this Python Workers project.
11
+
12
+ To get these installed you'll need `uv`, which you can install by following
13
+ https://docs.astral.sh/uv/getting-started/installation/.
14
+
15
+ Once `uv` is installed, you can run the following:
16
+
17
+ ```
18
+ uv venv
19
+ uv sync
20
+ ```
21
+
22
+ Then point your editor's Python plugin at the `.venv` directory. You should then have working
23
+ autocomplete and type information in your editor.
@@ -8,6 +8,6 @@
8
8
  "start": "wrangler dev"
9
9
  },
10
10
  "devDependencies": {
11
- "wrangler": "^3.60.3"
11
+ "wrangler": "^3.101.0"
12
12
  }
13
13
  }
@@ -0,0 +1,9 @@
1
+ [project]
2
+ name = "<TBD>"
3
+ version = "0.1.0"
4
+ description = "Add your description here"
5
+ readme = "README.md"
6
+ requires-python = ">=3.12"
7
+ dependencies = [
8
+ "webtypy>=0.1.7",
9
+ ]
@@ -0,0 +1,22 @@
1
+ version = 1
2
+ requires-python = ">=3.12"
3
+
4
+ [[package]]
5
+ name = "<TBD>"
6
+ version = "0.1.0"
7
+ source = { virtual = "." }
8
+ dependencies = [
9
+ { name = "webtypy" },
10
+ ]
11
+
12
+ [package.metadata]
13
+ requires-dist = [{ name = "webtypy", specifier = ">=0.1.7" }]
14
+
15
+ [[package]]
16
+ name = "webtypy"
17
+ version = "0.1.7"
18
+ source = { registry = "https://pypi.org/simple" }
19
+ sdist = { url = "https://files.pythonhosted.org/packages/5e/89/c7a0311fdc73809fc2415be97767f085ff3e00c86546430034dc8465fee7/webtypy-0.1.7.tar.gz", hash = "sha256:1b7212719a949c802f3d60fac5f0d952eb503a92121409cf1ad9847d7c76a336", size = 104505 }
20
+ wheels = [
21
+ { url = "https://files.pythonhosted.org/packages/61/91/c731bdaa605279e00b28bfd2bf0ae67f48061d16890fb1c026924bfbd242/webtypy-0.1.7-py3-none-any.whl", hash = "sha256:f35e6d73a4e08783e23adfac271a11cda3a2bd1105499db70e4819244efed0ae", size = 103519 },
22
+ ]
@@ -0,0 +1,9 @@
1
+ {
2
+ "name": "<TBD>",
3
+ "main": "src/entry.py",
4
+ "compatibility_date": "<TBD>",
5
+ "compatibility_flags": ["python_workers"],
6
+ "observability": {
7
+ "enabled": true,
8
+ },
9
+ }
@@ -10,9 +10,9 @@
10
10
  "cf-typegen": "wrangler types"
11
11
  },
12
12
  "devDependencies": {
13
- "@cloudflare/vitest-pool-workers": "^0.5.2",
13
+ "@cloudflare/vitest-pool-workers": "^0.6.4",
14
14
  "typescript": "^5.5.2",
15
- "vitest": "2.1.8",
16
- "wrangler": "^3.60.3"
15
+ "vitest": "~2.1.9",
16
+ "wrangler": "^3.101.0"
17
17
  }
18
18
  }
@@ -5,7 +5,7 @@
5
5
  * - Open a browser tab at http://localhost:8787/ to see your worker in action
6
6
  * - Run `npm run deploy` to publish your worker
7
7
  *
8
- * Bind resources to your worker in `wrangler.toml`. After adding bindings, a type definition for the
8
+ * Bind resources to your worker in `wrangler.jsonc`. After adding bindings, a type definition for the
9
9
  * `Env` object can be regenerated with `npm run cf-typegen`.
10
10
  *
11
11
  * Learn more at https://developers.cloudflare.com/workers/
@@ -4,7 +4,7 @@ export default defineWorkersConfig({
4
4
  test: {
5
5
  poolOptions: {
6
6
  workers: {
7
- wrangler: { configPath: './wrangler.toml' },
7
+ wrangler: { configPath: './wrangler.jsonc' },
8
8
  },
9
9
  },
10
10
  },
@@ -1,4 +1,4 @@
1
1
  // Generated by Wrangler
2
- // After adding bindings to `wrangler.toml`, regenerate this interface via `npm run cf-typegen`
2
+ // After adding bindings to `wrangler.jsonc`, regenerate this interface via `npm run cf-typegen`
3
3
  interface Env {
4
4
  }
@@ -0,0 +1,8 @@
1
+ {
2
+ "name": "<TBD>",
3
+ "main": "src/index.ts",
4
+ "compatibility_date": "<TBD>",
5
+ "observability": {
6
+ "enabled": true,
7
+ },
8
+ }
@@ -8,6 +8,6 @@
8
8
  "start": "wrangler dev"
9
9
  },
10
10
  "devDependencies": {
11
- "wrangler": "^3.60.3"
11
+ "wrangler": "^3.101.0"
12
12
  }
13
13
  }
@@ -11,7 +11,7 @@ import { DurableObject } from "cloudflare:workers";
11
11
  */
12
12
 
13
13
  /**
14
- * Env provides a mechanism to reference bindings declared in wrangler.toml within JavaScript
14
+ * Env provides a mechanism to reference bindings declared in wrangler.jsonc within JavaScript
15
15
  *
16
16
  * @typedef {Object} Env
17
17
  * @property {DurableObjectNamespace} MY_DURABLE_OBJECT - The Durable Object namespace binding
@@ -24,7 +24,7 @@ export class MyDurableObject extends DurableObject {
24
24
  * `DurableObjectStub::get` for a given identifier (no-op constructors can be omitted)
25
25
  *
26
26
  * @param {DurableObjectState} ctx - The interface for interacting with Durable Object state
27
- * @param {Env} env - The interface to reference bindings declared in wrangler.toml
27
+ * @param {Env} env - The interface to reference bindings declared in wrangler.jsonc
28
28
  */
29
29
  constructor(ctx, env) {
30
30
  super(ctx, env);
@@ -47,7 +47,7 @@ export default {
47
47
  * This is the standard fetch handler for a Cloudflare Worker
48
48
  *
49
49
  * @param {Request} request - The request submitted to the Worker from the client
50
- * @param {Env} env - The interface to reference bindings declared in wrangler.toml
50
+ * @param {Env} env - The interface to reference bindings declared in wrangler.jsonc
51
51
  * @param {ExecutionContext} ctx - The execution context of the Worker
52
52
  * @returns {Promise<Response>} The response to be sent back to the client
53
53
  */
@@ -0,0 +1,24 @@
1
+ {
2
+ "name": "<TBD>",
3
+ "main": "src/index.js",
4
+ "compatibility_date": "<TBD>",
5
+ "migrations": [
6
+ {
7
+ "new_classes": [
8
+ "MyDurableObject"
9
+ ],
10
+ "tag": "v1"
11
+ }
12
+ ],
13
+ "durable_objects": {
14
+ "bindings": [
15
+ {
16
+ "class_name": "MyDurableObject",
17
+ "name": "MY_DURABLE_OBJECT"
18
+ }
19
+ ]
20
+ },
21
+ "observability": {
22
+ "enabled": true
23
+ }
24
+ }
@@ -10,6 +10,6 @@
10
10
  },
11
11
  "devDependencies": {
12
12
  "typescript": "^5.5.2",
13
- "wrangler": "^3.60.3"
13
+ "wrangler": "^3.101.0"
14
14
  }
15
15
  }
@@ -7,20 +7,20 @@ import { DurableObject } from "cloudflare:workers";
7
7
  * - Open a browser tab at http://localhost:8787/ to see your Durable Object in action
8
8
  * - Run `npm run deploy` to publish your application
9
9
  *
10
- * Bind resources to your worker in `wrangler.toml`. After adding bindings, a type definition for the
10
+ * Bind resources to your worker in `wrangler.jsonc`. After adding bindings, a type definition for the
11
11
  * `Env` object can be regenerated with `npm run cf-typegen`.
12
12
  *
13
13
  * Learn more at https://developers.cloudflare.com/durable-objects
14
14
  */
15
15
 
16
16
  /** A Durable Object's behavior is defined in an exported Javascript class */
17
- export class MyDurableObject extends DurableObject {
17
+ export class MyDurableObject extends DurableObject<Env> {
18
18
  /**
19
19
  * The constructor is invoked once upon creation of the Durable Object, i.e. the first call to
20
20
  * `DurableObjectStub::get` for a given identifier (no-op constructors can be omitted)
21
21
  *
22
22
  * @param ctx - The interface for interacting with Durable Object state
23
- * @param env - The interface to reference bindings declared in wrangler.toml
23
+ * @param env - The interface to reference bindings declared in wrangler.jsonc
24
24
  */
25
25
  constructor(ctx: DurableObjectState, env: Env) {
26
26
  super(ctx, env);
@@ -43,7 +43,7 @@ export default {
43
43
  * This is the standard fetch handler for a Cloudflare Worker
44
44
  *
45
45
  * @param request - The request submitted to the Worker from the client
46
- * @param env - The interface to reference bindings declared in wrangler.toml
46
+ * @param env - The interface to reference bindings declared in wrangler.jsonc
47
47
  * @param ctx - The execution context of the Worker
48
48
  * @returns The response to be sent back to the client
49
49
  */
@@ -0,0 +1,24 @@
1
+ {
2
+ "name": "<TBD>",
3
+ "main": "src/index.ts",
4
+ "compatibility_date": "<TBD>",
5
+ "migrations": [
6
+ {
7
+ "new_classes": [
8
+ "MyDurableObject"
9
+ ],
10
+ "tag": "v1"
11
+ }
12
+ ],
13
+ "durable_objects": {
14
+ "bindings": [
15
+ {
16
+ "class_name": "MyDurableObject",
17
+ "name": "MY_DURABLE_OBJECT"
18
+ }
19
+ ]
20
+ },
21
+ "observability": {
22
+ "enabled": true
23
+ }
24
+ }
@@ -65,5 +65,6 @@ const config: TemplateConfig = {
65
65
  }),
66
66
  devScript: "dev",
67
67
  deployScript: "deploy",
68
+ previewScript: "dev",
68
69
  };
69
70
  export default config;
@@ -1,4 +1,4 @@
1
1
  // Generated by Wrangler
2
- // After adding bindings to `wrangler.toml`, regenerate this interface via `npm run cf-typegen`
2
+ // After adding bindings to `wrangler.jsonc`, regenerate this interface via `npm run cf-typegen`
3
3
  interface CloudflareBindings {
4
4
  }
@@ -0,0 +1,8 @@
1
+ {
2
+ "name": "<TBD>",
3
+ "main": "src/index.ts",
4
+ "compatibility_date": "<TBD>",
5
+ "observability": {
6
+ "enabled": true
7
+ }
8
+ }
@@ -47,10 +47,9 @@ In order to enable the example:
47
47
  // KV Example:
48
48
  ```
49
49
  and uncomment the commented lines below it (also uncomment the relevant imports).
50
- - Do the same in the `wrangler.toml` file, where
51
- the comment is:
50
+ - In the `wrangler.jsonc` file add the following configuration line:
52
51
  ```
53
- # KV Example:
52
+ "kv_namespaces": [{ "binding": "MY_KV_NAMESPACE", "id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" }],
54
53
  ```
55
54
  - If you're using TypeScript run the `cf-typegen` script to update the `env.d.ts` file:
56
55
  ```bash